鸿蒙开发:证书只能创建3个,第4个应用怎么办

之前上架了3款应用,当上架第4款应用的时候,申请证书时,提示数量已达上限:

点击申请发布证书详情查看,一个很耀眼的说明摆在了眼前:每个账号最多可申请3个发布证书。

当时就很诧异,怎么着,每个账号只能最多上架3款应用?这还有王法吗?这还有天理吗?我要上架第4款应用怎么办?走重新申请账号这条路,但是实名认证怎么办?诸多的疑问以为会堵死自己的开发之路,后面通过查完资料之后,才发现杞人忧天了,官方已经给我们准备了多个应用的上架之路,这篇文章就来讲清楚证书数量限制的来龙去脉,以及第4个,乃至更多应用的正确处理方式。

先搞清楚:证书为什么有数量限制

上架过应用的朋友都知道,HarmonyOS开发者中心的证书分可以分为两类,一类是调试证书,主要用于应用或者元服务的调试场景,构建可调试的安装包;还有一类就是发布证书,主要用于应用或者元服务的正式发布场景,打包上架华为应用市场的正式包。

每个账号最多可申请 3 个调试证书和 3 个发布证书 。当数量达到上限时,无论是 DevEco Studio 的自动签名还是手动申请,都会报出类似如下的错误 :

TypeScript 复制代码
The number of certificates has reached the limit. Delete some certificates and try again. Certificate Number Exceeds Limit.

很多开发者误以为"一个应用必须对应一个证书",其实这是对签名体系的误解。HarmonyOS 的签名体系由三个部分组成:

文件 作用 是否与包名强绑定
密钥库文件(.p12) 保存私钥 否,可复用
证书(.cer) 证明开发者身份 否,可复用
Profile(.p7b) 声明应用包名、权限、设备等签名信息 是,每个应用各一份

关键在于:证书是可以复用的,不同的应用可以使用同一个证书;而 Profile 与应用包名强绑定,不同应用使用的 Profile 一定不一样 。也就是说,证书数量限制并不会限制你能开发的应用数量,一句话解释就是:一个证书可以关联生成多个 Profile,从而签名多个应用。

多于三个应用的两种解决方案

当证书数量达到上限时,目前有两种官方推荐的处理方式:

1、废除对应类型下多余的证书。注意:废除前请确保该证书未被任何应用使用,否则关联的 Profile 会同步失效,已上架应用的版本更新会受影响。

2、让多个应用共用同一个证书。这是最推荐、也是可持续的做法,下文详细展开。

多应用共用一个证书的完整操作

以发布证书为例,假设当前证书已被应用 《鸿元工坊》 占用,其签名信息如下 :

应用包名:com.abner.component

签名库文件:abner.p12

证书文件名:abner.cer

Profile 文件名:component.p7b,关联的证书为 abner.cer

在 DevEco Studio 中为 《鸿元工坊》 配置的签名信息如下图所示。

此时要发布第4个应用《脑小练 》,只需要申请新的 Profile 文件。申请新的 Profile 时,"关联证书"选择已有的证书即可 。

新应用《脑小练》 的签名信息如下 :

应用包名:com.abner.brain

签名库文件:abner.p12(复用)

证书文件名:abner.cer(复用)

新的 Profile 文件名:nao.p7b,关联的证书为 abner.cer

综上:如果需要发布多个应用,可以使用同一个证书,仅需要为每个应用申请新的 Profile 文件,其他文件均可以复用。在工程配置层面,第四个应用的 build-profile.json5 中 signingConfigs 只需指向同一份 .p12 与 .cer,再替换为新应用的 Profile 文件即可。

几个容易踩的坑

1、证书删除/吊销的连带影响

如果软件包使用的证书文件已被删除或吊销,关联的 Profile 也会同步失效,上架应用更新版本时上传会失败(错误码 1005:证书文件非法)。此时需要删除失效的 Profile,重新申请证书和 Profile 后重新打包上传 。所以废除证书前务必确认没有任何在架应用或未发布版本依赖它。

2、Profile 有独立的数量上限

一个应用最多可申请 100 个 Profile 文件 ,这个上限远大于证书上限,一般不会成为瓶颈,但在频繁为同一应用申请调试/发布/指定设备发布 Profile 时需要留意。

3、证书有效期

实名认证开发者的发布证书有效期为 3 年。证书到期暂不影响在架应用,但更新版本时若上传过期证书签名的软件包会失败,建议及时更换证书与 Profile。共用证书的情况下,一次换证即可覆盖所有关联应用,这也是复用证书的额外好处。

4、自动签名场景

使用 DevEco Studio 自动签名时,如果账号下证书已满,同样会报数量超限错误。此时可以先在开发者中心清理无用证书,或改为手动签名并复用已有证书。

相关总结

我们需要知道的是,证书只能创建3个,并不是应用数量的天花板,而是提醒开发者建立正确的签名资产管理意识:

1、证书代表开发者身份,可跨应用复用。

2、Profile 代表单个应用的签名声明,与包名一一对应。

3、当有超过3个应用时,优先选择复用已有证书 + 申请新 Profile 的方案,而非盲目新增证书。

4、只有在证书确实不再被任何应用使用时,才考虑废除它。

相关推荐
bcbnb27 分钟前
Windows 上 iOS 开发接 CI,KXBuild 自托管 runner 出签名 ipa
后端·ios
阿杰m2 小时前
Android源码第十七章:PowerManager 与后台任务——锁屏后怎么跑?
android
JMchen1232 小时前
【Android 性能优化实战 60 讲】10 Jetpack App Startup 内核魔改:手写异步懒加载启动框架,根治串行初始化耗时
android·性能优化·源码分析·启动优化·kotlin协程·app startup
2601_967980113 小时前
python+appium自动化测试如何控制App的启动和退出
android·自动化测试·python·appium·设备调试
booboosui4 小时前
不写安装器:点一下就往对话里塞 152 个字符
android
威哥爱编程4 小时前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程4 小时前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos
一条破秋裤4 小时前
【1117】【内存资源管控】【笔记】
android·笔记
AI导出鸭PC端5 小时前
用 AI 导出鸭高效处理:豆包导 pdf 怎么压缩但清晰
android·人工智能·pdf·豆包·ai导出鸭