APK 安装与应用管理
从本地文件、直链或公开来源安装，并核对每个应用的结果。
准备目标设备与安装包
先启动目标设备，等待 Android 与安装通道就绪。处于暂停、停止中或状态异常的设备不能作为正常安装目标；如果已在安装，等待当前批次完成。
- 本地支持 .apk，以及包含同一应用所需 APK 分包的 .zip；本地校验上限为 1000 MiB，分包解压后的 APK 总量也受此限制。
- 不要把任意 ZIP、系统固件或多个不相关应用打包成一次分包安装；.xapk / .apks 并不是此入口承诺的直接支持格式。
- 应用是否可运行仍取决于 Android 版本、CPU 架构、图形、Google 服务及应用自身限制。安装成功只证明安装结果。
安装本地文件
- 确认要安装到哪台设备。将一个或多个 APK 拖到该设备的 Android 画面，可直接进入这台设备的安装队列。
- 也可点击 Android 右栏“安装 APK”选择文件；拖到控制中心时，则按选择窗口指定目标设备。
- 在“APK → 本地”导入文件是登记到本地列表；随后选择条目与目标设备安装。登记完成不等于已经装进 Android。
- 查看设备行的结果，打开“安装详情…”核对每个文件。最后在 Android 内找到应用并打开验证。
下载直链与公开来源
- 打开“APK → 远端”。单个文件使用“APK 链接”入口，填写名称和公开的 http(s) .apk 地址。
- 添加一组应用时，使用“添加来源”，填写来源名称与公开 index.json 仓库地址，再点“验证并添加”。
- 验证通过后可搜索应用名或包名，并按来源筛选。使用“检查更新”刷新来源索引；它不会自动更新 Android 内已安装的应用。
- 先从远端条目下载到本地，再选设备安装。下载中、下载完成和安装完成是不同阶段。
当前来源入口面向可匿名访问的公开仓库，不代存登录 Cookie 或令牌。返回登录网页、HTML 错误页或无效 APK 内容的地址会失败。删除来源会移除来源登记，已经下载的包会保留。
理解安装详情与取消
| 状态 / 操作 | 说明 |
|---|---|
| 排队中 | 尚未开始当前包。 |
| 正在下载 | 正在取得远端文件，不编造百分比。 |
| 正在安装 | 已进入当前应用的安装步骤。 |
| 已完成 / 失败 / 未装 | 逐项查看回执或原因，不用一条总提示代替所有结果。 |
| 取消后续安装 | 请求跳过尚未开始的应用，当前安装会继续收尾。 |
| 清空已结束记录 | 只清除已经结束的记录，不取消未完成任务。 |
关闭安装详情窗口不会中断安装。记录保留至退出应用；需要反馈时，请在退出前保存错误文本。
失败时如何处理
| 提示或现象 | 建议操作 |
|---|---|
| 目标未就绪 / ADB 不可用 | 恢复或启动设备，等 Android 完成启动，再查看“ADB 连接”中的当前端口。 |
| 架构或 SDK 不兼容 | 核对 APK 支持的架构和 Android 最低版本，更换适配的包或系统。 |
| 签名冲突 / 不允许降级 | 优先使用同一开发者签名的新版本。若必须卸载旧版，先导出应用数据；卸载可能清除数据。 |
| 空间不足 | 检查 Android 内部存储与 Mac 实际磁盘。必要时先备份，再扩容机身存储。 |
| 安装成功但无法启动 | 记录应用版本、系统镜像、复现步骤与画面；不要重复安装来代替兼容性排查。 |
更新、卸载与数据
更新时优先使用同一来源与签名的包，并检查安装详情。卸载应用在 Android 内的应用设置中完成；从 Mac 的 APK 列表删除或移走安装包，不等于卸载设备内的应用。卸载、清除应用存储和删除整个设备是三种不同的数据操作。