Android / 安装手册
Android 安装
Android 端把运行环境装进设备。安装包、Runtime 与上游脚本可以分别更新， 但首次启动必须先完成 Runtime 解压和 ADB 激活。
版本与更新以 GitHub Release 为准
先看边界
“免 Root”不等于零权限。你仍需开启开发者选项、无线调试并完成 ADB 配对。Android 9–10 首次激活需要一台电脑；部分厂商的后台限制也可能影响长期运行。
设备要求
- 系统：Android 9.0（API 28）及以上。
- 架构：仅 64 位，arm64-v8a 或 x86_64。没有 32 位构建。
- 存储：至少 2.5 GB 可用，推荐 5 GB。首次解压后占用会继续增长； 更新与日志也需要空间。
- 内存：建议 4 GB 以上，推荐 6 GB。长时间运行更依赖设备的散热与后台策略。
- 游戏：设备上需要已安装并登录对应区服的《碧蓝航线》客户端； 工具不提供游戏本体。
选择安装包
| 场景 | 文件 | 大概体积 |
|---|---|---|
| 首次安装在 arm64 手机 | arm64-v8a-full.apk | ≈ 1.17 GiB |
| 首次安装在 x86_64 设备 | x86_64-full.apk | ≈ 1.16 GiB |
| 已部署 arm64 Runtime 后更新 | arm64-v8a-update.apk | ≈ 263 MiB |
| 已部署 x86_64 Runtime 后更新 | x86_64-update.apk | ≈ 198 MiB |
full 包内置 rootfs；update 包不含 Runtime，不能用于首次安装。 版本号与文件大小可能随后续 Release 改变，以 Releases 页面 为准。国内网络可以优先使用 CNB 镜像。
安装与首次启动
- 下载并安装匹配架构的 full APK。需要允许安装未知来源应用； 系统提示文件较大属正常现象。
- 启动 AzurPilot，等待运行时解压。首次启动通常需要 1–3 分钟，期间请保持电量充足并保持联网。不要强制停止或清理应用数据。
- 授予通知、悬浮窗与电池优化豁免等必要权限。不同系统的名称可能不同。
- 打开 App 内的 AzurPilot 控制台，创建实例，确认可以获取虚拟屏画面。
ADB 激活
Android 11 及以上可以通过内置配对界面完成无线调试；Android 9–10 首次需要连接电脑执行一次端口切换：
adb tcpip 5555随后在 App 内完成配对。如果设备曾重启、撤销调试授权或清除应用数据， 可能需要重新激活。支持内置 shizuku-m 配对、外部 Shizuku 或 Root； 选择哪种方式取决于你的设备和风险偏好。
- 确保开发者选项与无线调试处于开启状态。
- 配对码只在配对过程中有效；不要把配对端口和口令公开发布。
- 联发科设备有针对启动阶段的兼容处理，但不同 ROM 仍可能有差异。
虚拟屏与后台运行
Android 端用 Android 虚拟显示层承载游戏实例，并通过共享内存帧通道读取画面。 主屏可以继续使用其他应用；悬浮窗提供快速启停、队列查看和日志浏览。
App 内置多重后台保活机制，但这不等于在所有机型上都能稳定锁定后台。 长时间运行时建议充电、关闭厂商省电限制并保持足够散热。
更新与数据
App、Runtime 和上游脚本是相互解耦的三条更新轨。覆盖安装 update 包不会覆盖已解压的 Runtime 与配置；Runtime 更新会保留 config 与数据卷。上游脚本的热更新优先使用 CNB， 涉及底层依赖变更时会转为完整 Runtime 更新。
更新前建议在设置中检查当前版本和运行时状态，并保留重要配置。 运行中的任务应先结束或等待收尾，再执行 Runtime 重启或更新。
常见问题
- 安装后卡在解压：确认存储空间充足并在 Wi-Fi 环境下重新启动； 不要中途清理 App 数据。
- 无法连接虚拟屏：检查 ADB 激活状态、开发者选项与电池策略。 首次激活失败时先重启设备再重新配对。
- 识别失败：确认游戏客户端与实例区服一致、画面比例正常、 没有遮挡元素。先在虚拟屏里测试截图和点击。
- 后台任务中断：检查厂商后台限制、省电模式与剩余内存。 必要时固定通知、允许后台运行或使用 Root 方式配合系统策略。
- 更新后无法启动：保留日志并查看 Release 说明；不要用来路不明的 rootfs 替换内置运行时。