构建、签名与发布

Android 版的发布是「一套源码，多种产物」：按 ABI 的完整 APK、双 ABI 轻量 APK、按 ABI 的 Runtime 包，全部挂在同一个固定 Release 下。

构建产物

产物	构建参数	内容
完整 APK（单 ABI）	assembleRelease -Pazurpilot.releaseAbi=<abi>	内置对应 rootfs
完整 APK（双 ABI）	assembleRelease	省略 ABI 参数
轻量 APK	assembleDebug/Release -Pazurpilot.slimApk=true	无 rootfs，双 ABI
Runtime	CI rootfs.yml	rootfs-<abi>.tar.xz + BUILD_MANIFEST

cd app
./gradlew compileDebugKotlin -x verifyBundledAzurPilotRuntime
./gradlew assembleDebug -Pazurpilot.slimApk=true
./gradlew assembleRelease -Pazurpilot.releaseAbi=arm64-v8a

Release 开启 R8 混淆，assembleRelease 末尾自动跑 verifyReleaseR8Keeps，确认反射与 JNI 入口没被裁掉。

版本规则

项	规则
versionCode	本仓 HEAD 提交时间戳；事故时可用 APP_VERSION_CODE 手钉
versionName	1.<series>.<X>，X = 提交计数 − 基线
基线	定义在 GitVersion.kt，CI 的 resolve 步使用同一公式

两处必须同步

GitVersion.kt 的基线与 .github/workflows/rootfs.yml 的正则/公式必须一起改。只改一处会导致本地与 CI 版本号漂移。仓库文档中出现过不同基线的历史记录，以当前 GitVersion.kt 为准，不要照抄旧数字。

CI 用 git diff --quiet "$app_commit" HEAD -- app 判断 Android 工程输入是否变化：

• 未变 → 沿用已发布 app 版本，可只发 Runtime。
• 变了 → versionCode = max(旧值 + 1, HEAD 时间戳)，versionName 按公式计算。

「app 版本没变」不等于「不需要重建 Runtime」——rootfs 与工作流变化同样会触发产物重建。

签名

场景	密钥	说明
Release	仓库外 keystore（CI Secrets）	v1 + v2 + v3 全开
Debug	仓内固定 debug.keystore	保证所有机器产出的 debug 包可互相覆盖

四项配置：KEYSTORE_PATH / KEYSTORE_PASSWORD / KEY_ALIAS / KEY_PASSWORD。环境变量优先，app/local.properties 兜底。

没有 keystore 时 release 保持未签名，构建不失败，但产物装不上，只用于编译验证。

签名不一致 = 只能卸载重装

INSTALL_FAILED_UPDATE_INCOMPATIBLE 意味着数据全丢。debug 与 release 互切前先导出配置。

CI 流程

.github/workflows/rootfs.yml，推送 main 或手动 dispatch 触发：

阶段	内容
resolve	取上游 AzurPilot dev head；比较输入，决定是否跳过构建
build	按 ABI 矩阵在原生 runner 构建 rootfs（rootfs/build/build-azurpilot.sh）
apk	先 fetch-proot-libs.sh，再出按架构完整包与通用轻量包
publish	上传固定 Release azurpilot-android-latest，更新 latest.json

另有 .github/workflows/check-upstream.yml 跟踪上游变化。

本地复刻 release

1. 从成功的 CI run 下载 rootfs-<abi> 产物。
2. 把 rootfs.tar.xz 与 BUILD_MANIFEST 放进 app/app/src/main/assets/rootfs/。
3. 配好 KEYSTORE_*。
4. cd app && ./gradlew assembleRelease -Pazurpilot.releaseAbi=arm64-v8a。

发布清单

固定 Release 的 latest.json：

字段	说明
versionCode / versionName	App 更新
appCommit	上次真正构建 APK 的提交
azurpilotCommit	Runtime 内的上游提交
androidHostCommit	构建 Runtime 的本仓提交
apkUrl / apkSha256 / apkSize	通用轻量包
updateApks.<abi>	按架构轻量包
runtimes.<abi>	按架构 Runtime
fullApks.<abi>	按架构完整 APK
rootfs*	兼容字段，恒指向 arm64

兼容规则：旧版 App 只读扁平 rootfs* 字段，所以它们必须始终有效。新版按 ABI 选 updateApks，防止 MuMu 把通用包切成 ARM 转译。

多架构

ABI	用途	说明
arm64-v8a	真机	主目标
x86_64	模拟器	proot 库需单独获取

不支持 32 位：Runtime 依赖 64 位 Linux 二进制。详见 doc/multi-arch.md。

镜像与下载源

• GitHub 与 CNB 都维护固定标签，大小与 SHA-256 一致。
• 新安装默认 cnb；已保存的选择不变。
• 内置五个 ghproxy 形态镜像，设置里也可填自定义前缀（非法输入回落直连）。
• 实测 gh-proxy.net 会返回挑战页，不可用于下载。

构建配置（build profiles）

doc/build-profiles.md 描述了 PI 打包配方、身份覆盖与验证方式。带包名后缀的 profile 需要同步修改 tools/watch-android-logs.ps1 里的 $package。

发布检查清单

• [ ] GitVersion.kt 与 CI 公式一致
• [ ] Cargo.toml / tauri.conf.json 不涉及（那是启动器）
• [ ] CHANGELOG.md 已更新
• [ ] rootfs 按 ABI 构建成功
• [ ] 完整包与轻量包都产出
• [ ] 签名验证通过（apksigner 分档）
• [ ] latest.json 字段完整、兼容字段指向 arm64
• [ ] 在至少一台 ARM64 真机与一台 x86_64 模拟器上安装验证
• [ ] 热更接口返回符合预期（enabled / requiresRuntimeUpdate）