指南摘要
完成 Android 签名密钥注册,选择实际分发证书、处理不符合条件的密钥、补充渠道签名,并区分注册错误与 AAB 上传错误。
适合人群: 在登记已有应用时遇到合格密钥列表、添加密钥或签名不匹配提示的发布负责人。
发布检查步骤
- 收集各活跃渠道实际交付的 APK。
- 提取公开证书 SHA-256,并标注应用签名、上传、历史或渠道用途。
- 选择匹配的合格密钥;无法选中时使用官方请求或审核路径。
- 为真实分发版本补齐合法证书,完成对应所有权证明后重新查询。
关键事实
生产密钥不在候选列表中,不是立即换密钥的理由。保留升级连续性,先核对产物与证书角色,再提交分发历史或走官方审核。
详细说明
登记用户安装版本的签名证书
使用 Play App Signing 时,Play 交付的 APK 由应用签名密钥签署,上传密钥只验证提交到 Play 的 AAB。官网或另一商店的生产 APK 可能有自己的证书。
逐个提取实际 APK 的 SHA-256 并标注渠道。熟悉的 keystore 别名不能证明它签署了这份安装包;判断应基于完整指纹。
- Play 交付:应用签名证书。
- Play 上传:上传证书,用途不同。
- 其他渠道:检查各自正式产物。
apksigner verify --print-certs app-release.apk候选密钥不符合条件时如何处理
已有包名的控制台可能列出与分发历史有关的候选密钥。先选择与用户收到版本相符的那一项;若正确生产密钥不可选,排除误用上传或 debug 证书,再提交请求或审核并说明历史渠道。
新包名按当前控制台流程登记,同时把账号、包名和证书保存在发布记录里。不要为让列表出现新项而临时创建替代密钥,这会让原有版本的身份关系更难追溯。
- 比较 SHA-256,而非别名。
- 保留旧版本与渠道证据。
- 继续保护维持用户升级的原生产密钥。
补充真正用于分发的其他密钥
不同渠道或已批准的签名历史可能让一个包名合法使用多张证书。通过官方添加密钥流程逐项登记,并给每个指纹标明产物、渠道和负责人。
若要求所有权证明,用匹配的私钥签署挑战 APK。流程可能涉及 adi-registration.properties,但只提交所需的已签名产物,不提交私钥本身。等控制台处理完成后,再查询该组合。
- 只添加真实分发产物使用的证书。
- 私钥继续保留在原签名系统。
- 保留挑战与完成记录,便于日后复核。
区分注册不匹配与 Play 上传密钥错误
注册不匹配表示包名记录与所查证书不同;Play 提示 App Bundle 使用错误密钥,通常是在核对 AAB 上传身份。两种提示可能涉及同一个应用,但处理入口不同。
注册问题用包名与公开证书查询来验证;AAB 被拒则查看 Play 的证书页及上传指引。只有弄清失败层次后,才评估哪项官方密钥流程适用,避免同时更换两类密钥。
- 注册检查:包名与公开证书。
- AAB 上传失败:预期上传证书。
- 用户安装的 Play APK:应用签名证书。
填入正式包名;要核对实际 APK 的签名,再补充该产物的公开证书 SHA-256。查询用于发现登记问题,不能代替商店审核。
运行状态检测 →常见问题
同一包名可以注册多个签名密钥吗?
可以,前提是它们代表真实分发渠道或允许的签名历史。为每个 SHA-256 保留渠道与产物说明,并通过官方添加密钥流程完成证明,不能把任意测试密钥无区别加入。
启用 Play App Signing 应选哪把密钥?
验证 Play 用户安装的版本时,使用应用签名证书。上传证书验证 AAB 提交,可以与它不同。如果检查的是官网或其他商店,应回到该渠道的 APK 读取真实签名。
生产密钥不在合格列表里怎么办?
先证明它确实签署当前分发版本,而不是误选上传或 debug 证书。然后使用控制台请求或审核流程,提交所需分发历史。不要通过临时换密钥来绕过归属问题。
需要上传私钥吗?
不需要。注册比对公开证书,所有权挑战可能要求由匹配私钥签署的 APK,但私钥仍在你的 keystore 或签名服务里。按官方控制台要求提交产物,不向本站发送私有材料。
为什么 Play 说 App Bundle 使用了错误密钥?
这通常针对 Play 预期的上传证书,而不直接等于开发者验证登记证书错误。先对照 Play Console 的上传指引和证书页,确定上传身份,再决定是否需要官方恢复流程。
来源与审核
最后审核: