wangjia
480ce836bb
Deploy / build-linux-web (push) Successful in 53s
Deploy / build-windows (push) Successful in 1m48s
Deploy / build-macos (push) Successful in 1m17s
Deploy / build-android (push) Successful in 4m13s
Deploy / build-ios (push) Successful in 9s
Deploy / release-deploy (push) Successful in 1m37s
移动端响应式适配（抽屉导航/列表卡片/弹窗自适应）、Android 正式签名与 APK 发布、 iOS(TestFlight) 工程与 CI、多平台构建流水线、相关文档同步。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
Android 正式签名 — 一次性配置
CI 用正式 release keystore 给 APK 签名。keystore 不入库，通过 Forgejo Secrets 注入。 本文档是一次性操作，配置完成后每次打 tag 自动签名打包。
本地构建无需做这些：缺少
key.properties时flutter build apk自动回退 debug 签名。
1. 生成 keystore（本地执行一次）
keytool -genkeypair -v \
-keystore jiu-release.jks \
-alias jiu \
-keyalg RSA -keysize 2048 -validity 10000 \
-storepass '<你的store密码>' \
-keypass '<你的key密码>' \
-dname "CN=Yanmei, OU=Jiu, O=Yanmei, L=, ST=, C=CN"
务必妥善保管 jiu-release.jks 与两个密码：一旦丢失，已安装用户将无法收到覆盖升级（签名不匹配）。
建议把 jiu-release.jks 备份到 ~/.env 同级的安全位置（勿提交到仓库）。
2. 生成 base64（供 CI 注入）
base64 -i jiu-release.jks | pbcopy # macOS：已复制到剪贴板
3. 在 Forgejo 仓库配置 Secrets
仓库 → Settings → Actions → Secrets，新增 4 项：
| Secret 名 | 值 |
|---|---|
ANDROID_KEYSTORE_BASE64 |
第 2 步的 base64 字符串 |
ANDROID_KEYSTORE_PASSWORD |
store 密码 |
ANDROID_KEY_ALIAS |
jiu |
ANDROID_KEY_PASSWORD |
key 密码 |
4. 验证
打一个 tag 触发流水线，确认：
build-androidjob 绿，产出jiu-android.apk；- 日志出现
configuring release signing（而非falling back to debug signing）； - 下载安装后，下次升级能覆盖安装（签名一致）。
工作原理
client/android/app/build.gradle.kts：存在key.properties则用正式签名，否则回退 debug。scripts/ci/compile-android.sh：从ANDROID_KEYSTORE_BASE64还原 keystore，写出key.properties，构建后清理。key.properties、*.jks、*.keystore已在client/android/.gitignore中忽略。