原生移动开发 / 系统课时
建立发布记录与归档清单
建立发布记录与归档清单
一次发布如果只留下“包已经上传”的记忆,几周后就很难回答它来自哪次提交、使用什么版本号、由谁签名、投放到哪个渠道以及审核结果如何。本节把这些信息整理成可核验的发布档案。
学习目标
- 为每次 Android 发布建立稳定、可检索的记录字段
- 用提交 ID 与产物哈希把源码和实际上传文件关联起来
- 区分应归档的信息与不应进入发布记录的敏感凭据
一条发布记录要能回答什么
发布档案的核心不是“字段越多越好”,而是能够从线上版本反查到源码、构建产物和商店操作。建议至少记录:发布编号、Git 提交、versionCode、versionName、产物文件名与 SHA-256、签名证书指纹或密钥标识、发布渠道、提交时间、审核结果和最终放量状态。
| 信息 | 建议记录内容 | 用途 |
|---|---|---|
| 源码基线 | Git commit、tag 或 release 分支 | 复现当时源码 |
| 版本身份 | versionCode、versionName |
对应设备与商店版本 |
| 构建产物 | AAB/APK 文件名、SHA-256 | 确认上传文件未被替换 |
| 签名信息 | 证书指纹、key alias 或密钥系统中的引用 | 核对签名连续性 |
| 发布过程 | 渠道、提交时间、审核结果、放量状态 | 还原商店操作 |
| 关联事项 | 需求、缺陷、事故或回滚记录 ID | 解释为什么发布 |
用提交 ID 和哈希锁定发布产物
归档时不要只复制文件名,因为同名 app-release.aab 可以被后续构建覆盖。至少记录当前提交 ID,并对最终准备上传的 AAB 计算 SHA-256。
git rev-parse HEAD
sha256sum app/build/outputs/bundle/release/app-release.aab预期输出
<COMMIT_ID>
<SHA256> app/build/outputs/bundle/release/app-release.aab<COMMIT_ID> 和 <SHA256> 每次都会不同。若在 macOS 上没有 sha256sum,可使用系统提供的等价 SHA-256 工具,但团队应固定一种记录格式,避免同一字段混用不同算法。
把记录做成可审计的清单
发布记录可以放在工单系统、发布平台或版本库中的受控文档里,关键是每次发布都填写同一组最小字段。以下 YAML 只作为记录结构示例,不包含密钥或密码。
releaseId: "android-prod-2026-09-19-01"
gitCommit: "<COMMIT_ID>"
versionCode: 42018
versionName: "4.2.1"
artifact:
file: "app-release.aab"
sha256: "<SHA256>"
signing:
certificateFingerprint: "<FINGERPRINT>"
keyReference: "<KEY_REFERENCE>"
distribution:
channel: "production"
submittedAt: "<TIME>"
review:
status: "approved"
resultReference: "<ID>"生效行为与验证方法:完成提交后,用商店后台显示的版本号、实际上传文件和审核状态逐项回填;再从记录中的 Git 提交重新检出源码,确认能够定位到对应版本配置。记录中的动态值应替换为真实值。
不要把秘密当作归档信息
发布记录需要证明“用了哪把钥匙”,但不需要保存“钥匙本身”。不要把 keystore 文件、私钥、上传密钥密码、服务账号密钥或恢复码直接写进 Git、普通文档或发布表格。记录证书指纹、alias、密钥管理系统中的引用位置和负责人即可。
让记录真正可追踪
最实用的做法是为每次生产发布分配唯一 releaseId,并让它同时出现在发布工单、构建产物目录、商店提交记录和事故记录中。这样遇到审核退回、紧急修复或线上问题时,可以从任一入口快速找到完整链路,而不是依赖某位成员的聊天记录或本地文件。