KaiOS 2.5.X 使用 WebIDE 安装以及调试第三方应用程序

本教程将展示使用 Waterfox Classic 安装为 KaiOS 2.5.x 设计的应用，同时我们也非常推荐使用它来进行安装和调试应用。

本教程本身不会对手机产生任何损害，但请注意，你必须信任你所安装的应用是安全、无任何威胁的，WebIDE不会验证应用的安全性，Momo Trace 不对因使用 WebIDE 安装恶意应用程序所产生的问题承担任何责任

前期准备

Waterfox Classic 浏览器(担心版本更变准备的安装包，密码1145)
adb 驱动，macOS 和 Linux 可忽略（可从此处下载：https://cloud.189.cn/web/share?code=zEVVbeV7Jr6f （访问码：jml2），文件名: ADBDriverInstaller.exe）
Android SDK Platform Tools 最新版本下载地址，macOS 和 Linux 发行版可通过其对应的包管理器（如 Homebrew(macOS)、Pacman(Arch Linux)、apt(Debian/Ubuntu)、Yum/Dnf(RedHat)）安装，包名为 android-platform-tools，Linux 发行版需自行寻找。
一部运行 KaiOS 2.5.x 或 Firefox OS 2.x 的手机以及一根 microUSB 数据线

注意：本教程以下步骤均假设你所使用的系统为 Windows 10。且手机为 HMD 公司所发布的诺基亚 KaiOS 2.5.x 设备：8110 4G (2.5.1)/2720 Flip (2.5.2.1)/800 Tough (2.5.2.1)/6300 4G (2.5.4.1)/8000 4G (2.5.4.1)

准备开发环境

连上手机，在手机拨号盘输入 *#*#33284#*#* 后，打开 ADBDriverInstaller.exe 发现设备后点击 Install 即可安装驱动。
从 Waterfox 官网找到 Waterfox Classic，选择你所运行的平台下载或用我准备的安装包（密码1145)安装，截至目前的版本（2021.09）该浏览器的 WebIDE 均保留且可以正常使用，与 Firefox 52.9/59.0 和 Palemoon 28.6.1 相比取消了 WebIDE 难以使用的代码编辑器，同时 ADB Helper 可以正常使用，你可以选择你所喜欢的代码编辑器甚至专业 IDE 来编写应用（如 Visual Studio Code、WebStorm、HBuilder X 等）。

为了让 Waterfox Classic 的 ADB Helper 可以正常使用，同时为了以后方便通过 cmd 使用，我们推荐将 Android SDK Platform Tools 解压到任意的目录（路径最好不要有中文），并编辑环境变量（在 Windows 任务栏上的搜索中或在控制面板搜索环境变量可以找到），将 platform-tools 内的 adb 所在的路径添加到 Path 下（用户变量下的可重启 cmd 立即生效，系统变量下的需重启系统后生效）。

设置成功后可在 cmd 中确认 adb 是否可被调用，输入 adb version，输出以下内容说明环境变量配置成功：

准备 WebIDE

启动 Waterfox Classic，首次启动可能默认语言为英语，可在右上角的汉堡菜单中点击 Options，在 Locale Select 下找到 Chinese Simplified - 中文 (简体) 并按照提示重启浏览器后即可生效。

同样是在汉堡菜单，点击 开发者，找到 WebIDE，点击后即可进入 WebIDE 界面，你也可以通过快捷键 Shift + F8 快速进入：

在 WebIDE 窗口下的菜单栏里找到 项目 --> 管理额外组件，安装 ADB Helper 附加组件 和 工具适配器扩展，这两个扩展有可能在启动 WebIDE 后就已经自动安装完毕，需检查。

准备手机

正常情况

确认你的手机进入了 Debug 模式（即手机状态栏有一个背后为 T 的甲虫图标），若无可在拨号盘输入 *#*#33284#*#* 后进入，为保证可以正常连接，请彻底关闭任何手机助手以及任何安卓模拟器软件（因为这些软件不同版本的 ADB 会与你所配置的版本冲突）：
确认手机已经接入电脑，现在你可以在右侧面板的 USB 设备 中找到你的手机，点击后即可连接，注意此时有可能会断连，再次点击即可：

连接成功后会在右上角此处显示一个蓝色的手机图标和设备名称：

如果无法通过 USB 设备直接连接

如果因为系统配置等我们无法预料的原因导致无法在 WebIDE 中通过 USB 设备 直接连接，你可以使用 KaiOS Technologies 公司建议的方式：

在 cmd 中，输入以下命令：

adb forward tcp:6000 localfilesystem:/data/local/debugger-socket

此时该命令会返回 TCP 端口 (6000)。

此时在右侧面板的 其他 选择 远程运行环境，在弹出的窗口输入 localhost:6000，点击确定后即可连接成功，效果等同于直接连接，区别是右上角则会显示 远程运行环境。

安装应用

对于在网络上找到的应用程序包（zip 格式的压缩包），请将其解压，若为商店包或为 OmniSD 包（压缩包内有 application.zip 和 metadata.json），请进一步解压 application.zip 直到可以看到 manifest.webapp 文件，这是该应用程序的清单文件。

在左侧面板点击 打开打包式应用... 双击含有 manifest.webapp 文件的目录，点击 选择文件夹 后即可显示应用程序的基本信息。
\(（若上面的运行按钮（即等边三角形图标）可以正常点击，可无视警告，不影响后续安装）：\)

点击运行按钮，稍等片刻后会直接在手机上安装并运行该应用程序：

普通用户在此可以止步，因为此时应用已经安装完毕，并有 下载完成 的推送通知：

注意：通过 WebIDE 安装的应用程序均不支持自动更新，若有更新请通过以上步骤手动通过 WebIDE 更新