问题现象
HarmonyOS应用打包使用的证书有调试证书和发布证书区分,上架应用市场的应用必须用发布证书打包,而发布证书打包的应用无法安装,因此怎么获取发布上架包的签名信息呢?
背景知识
HarmonyOS应用经常需要集成一些开放能力,不管是华为开放能力还是三方能力,都需要做鉴权,鉴权的方式根据不同产品提供,一般是通过软件包的签名信息做鉴权,签名信息依赖于证书,而HarmonyOS应用打包有调试证书和发布证书区分,上架应用市场的应用必须用发布证书打包,为了保证应用上架后用户的体验,因此必须配置在架应用的签名信息。签名信息一般可通过公钥指纹和appId来承载。应用相关如:
- 华为开放能力使用公钥指纹鉴权,涉及的场景服务有华为账号,应用内支付,钱包服务等。具体的操作步骤可以参见配置公钥指纹。
- 部分三方服务使用appId鉴权,具体的获取方式参考bundleInfo.signatureInfo.appId。正确的appId形式为:"包名_签名信息"。
解决方案
不管是本地调试包还是上架包,签名信息都依赖于密钥库文件(p12文件),只要保证上架的app包使用的和本地调试的hap一样的p12文件,则相关的公钥指纹或者appId都不会发生变化。
- 本地调试包获取appId的方式有两种:
- 上架包获取appId的方式也有两种。
- 如前面简述,如果上架包使用的和本地调试包一样的p12文件,则可以参考本地调试包的方式获取appId。
- 发布邀请测试,从应用市场安装应用,然后通过bm工具获取,该方式也可以进一步验证同一p12编译的软件包appId是一致的。
常见FAQ
Q:公钥指纹和appId是什么关系,怎么获取公钥指纹?
A:不管公钥指纹还是appId,都是签名信息的表现形式,公钥指纹在HarmonyOS 开发者中心上生成证书后可以直接获取,参见配置公钥指纹。
Q:公钥指纹和appId可以相互转换吗?
A:通过公钥指纹暂时无法计算对应的appId,但获取appId后可以通过hash算法计算公钥指纹,具体操作有:
- 获取appId,如:com.example.demo_BWashfosahfsoafjsoafhj*************************ASDASAFdsafdDFAawWS=;
- 去除包名信息,获取签名信息保存为txt文件,如sign.txt。
- Windows系统下可通过certutil -hashfile sign.txt SHA256命令获取,Mac系统下可通过shasum -a 256 sign.txt命令获取。
Q:指纹配置成功后大约25小时生效,能否加速生效?
A:配置公钥指纹10分钟后,您可通过修改应用工程中app.json5中的versionCode触发公钥指纹生效。
总结
- 不管是本地调试包还是上架包,签名信息都依赖于密钥库文件(p12文件),只要保证上架的app包使用的和本地调试的hap一样的p12文件,则相关的公钥指纹或者appId都不会发生变化。
- 签名信息是唯一的,通过签名信息能很好的完成业务的鉴权,一般表现形式是公钥指纹或appId。部分业务通过fingerprint鉴权,但是使用的签名证书发生变化时,fingerprint也会发生变化。因此涉及到该业务要及时关注fingerprint的值是否正确。