原生移动开发 / 系统课时
验证 APK 的签名信息
验证 APK 的签名信息
APK 能正常生成并不代表它一定使用了正确证书。发布前应直接检查最终产物,确认签名有效、签名方案符合预期,并核对证书指纹,避免误用 Debug Key、旧项目密钥或错误的 CI 凭据。
学习目标
- 使用 Android SDK 的
apksigner验证 APK 是否通过签名校验。 - 读取签名方案与证书 SHA-256 指纹。
- 将最终产物的证书与预期发布证书进行比对。
找到 apksigner
apksigner 随 Android SDK Build Tools 提供。若它已加入 PATH,可以直接执行 apksigner;否则可从 SDK 的 build-tools/<VERSION>/ 目录调用。先确认工具可用:
apksigner version预期输出是当前 Build Tools 对应的版本号,例如:
<VERSION><VERSION> 会随本机安装的 Android SDK Build Tools 版本变化。
验证 APK 与签名方案
对最终准备发布的 APK 执行验证,而不是对中间产物或 Debug APK 执行。主命令如下:
apksigner verify --verbose --print-certs app-release.apk签名有效时,输出会包含 Verifies,随后列出各签名方案是否启用以及签名证书信息。不同 Build Tools 版本和 APK 配置会影响具体行数,可重点核对这些字段:
Verifies
Verified using v1 scheme (JAR signing): <BOOLEAN>
Verified using v2 scheme (APK Signature Scheme v2): <BOOLEAN>
Verified using v3 scheme (APK Signature Scheme v3): <BOOLEAN>
Number of signers: <COUNT>
Signer #1 certificate DN: <CERT_DN>
Signer #1 certificate SHA-256 digest: <CERT_SHA256><BOOLEAN>、<COUNT>、<CERT_DN> 和 <CERT_SHA256> 都应以实际输出为准。对于现代 Android 发布包,是否启用 v1、v2、v3 取决于最低系统版本、构建工具和签名配置,不要机械要求所有方案都为 true。
核对证书是否正确
验证成功后,最重要的是比较 Signer #1 certificate SHA-256 digest 与团队保存的发布证书指纹。指纹一致,才能确认这不是“签名有效但签错密钥”的情况。
如果你的发布流程使用 Google Play App Signing,要区分上传密钥证书和应用签名证书:本地构建并上传的 APK 可能使用上传密钥,而商店分发给用户的 APK 由平台使用应用签名密钥重新签名。比较指纹时必须先明确正在验证哪一个产物。
若输出显示多个 signer,还应确认这是否符合预期的签名轮换或多签名配置;不清楚来源时不要直接发布。
发现异常时怎么处理
若命令退出失败并提示签名校验错误,应重新检查 APK 是否被修改、是否下载损坏,或是否在签名后又执行了会改变 APK 内容的处理。修复后重新构建或重新签名,再次运行同一条验证命令。
如果签名校验通过,但 SHA-256 指纹与预期不一致,应立即停止发布。优先检查 Gradle 的 release.signingConfig、CI 注入的 keystore 与 alias,以及构建脚本是否存在二次签名步骤。不要只因为 APK 可以安装就认为它可用于正式升级。
最终验收应同时满足两件事:apksigner verify 通过,且证书 SHA-256 指纹与当前发布流程要求的证书一致。这样才能把“文件有签名”和“文件由正确密钥签名”区分开。