签名登记

Android 签名密钥注册:选择合格证书、添加密钥与排错

Android 开发者验证登记的是分发应用所用的公开签名证书。一个包名可以有多把合法密钥,但 Play 应用签名、上传密钥和其他渠道签名用途不同。先确定用户安装的 APK 由谁签署,再选择或补充对应证书。

指南摘要

完成 Android 签名密钥注册,选择实际分发证书、处理不符合条件的密钥、补充渠道签名,并区分注册错误与 AAB 上传错误。

适合人群: 在登记已有应用时遇到合格密钥列表、添加密钥或签名不匹配提示的发布负责人。

发布检查步骤

  1. 收集各活跃渠道实际交付的 APK。
  2. 提取公开证书 SHA-256,并标注应用签名、上传、历史或渠道用途。
  3. 选择匹配的合格密钥;无法选中时使用官方请求或审核路径。
  4. 为真实分发版本补齐合法证书,完成对应所有权证明后重新查询。

关键事实

登记值公开证书 SHA-256
一个包名可关联多把已验证的合法密钥
不得提交私钥、keystore 或密码
注意事项

生产密钥不在候选列表中,不是立即换密钥的理由。保留升级连续性,先核对产物与证书角色,再提交分发历史或走官方审核。

详细说明

登记用户安装版本的签名证书

使用 Play App Signing 时,Play 交付的 APK 由应用签名密钥签署,上传密钥只验证提交到 Play 的 AAB。官网或另一商店的生产 APK 可能有自己的证书。

逐个提取实际 APK 的 SHA-256 并标注渠道。熟悉的 keystore 别名不能证明它签署了这份安装包;判断应基于完整指纹。

  • Play 交付:应用签名证书。
  • Play 上传:上传证书,用途不同。
  • 其他渠道:检查各自正式产物。
检查正式 APK 的签名
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 的上传指引和证书页,确定上传身份,再决定是否需要官方恢复流程。

来源与审核

最后审核: