HarmonyOS鸿蒙Next关于上架分发使用指导

上架

1、上架后是否修改可兼容设备类型？

说明：

• 请确保软件包里声明的设备范围大于等于AGC上勾选的支持设备范围。
• 在应用发布前，您都可以修改支持设备，支持由单设备改为多设备，或多设备改为单设备。但是应用一旦发布，升级时仅允许增加设备类型，不支持删除原有在架应用已选择的设备类型。例如，在架应用支持的设备类型为“手机”，升级应用时您无法取消勾选“手机”选项。

注意事项

• 秘钥库文件(.p12)：通过DevEco Studio生成，秘钥包含非对称加密中使用的公钥和私钥。
• 证书请求文件(.csr)：通过DevEco Studio生成，包含密钥对中的公钥和公共名称、组织名称、组织单位等信息，用于向AppGallery Connect申请数字证书。
• 数字证书文件(.cer)：在AGC上通过证书请求文件.csr生成对应的调试证书或发布证书。

2、关于受限权限

• 当前受限ACL权限申请仅支持中国大陆地区。
• 选择权限时，请注意各权限支持的设备类型，确保软件包声明的设备类型范围不超出申请的权限支持的设备类型范围，否则将导致应用/元服务安装失败。
• 一次最多可勾选申请10条权限。必须等待上一次权限申请审批结束后，才可提交新的权限申请。

3、关于证书文件及签名

a. 证书文件是否可以复用（证书复用的前提是共用一个发布证书）

一个账号可以申请3个发布证书+1个调试证书。

b. 证书和profile文件都是这个月过期，新生成也是12.27过期？

• profile是跟证书绑定的，如证书是12.27过期，新生成的profile也是12.27号过期。

c. 使用调试证书和调试profile签名后就能在任何HarmonyOS设备上安装吗？

• 不能，只有调试profile文件中添加了对应UDID的设备才能安装，其他设备无法安装。

d. 发布证书和调试证书有什么区别，发布Profile和调试Profile有什么区别？

• 发布证书和发布Profile用于在应用上架时对APP进行签名，调试证书和调试Profile用于在本地调试时对HAP进行签名。
• 调试证书不可以用来上架发布，同理发布证书不能用来调试调试profile与发布profile流程上的区别：

e. AGC重签名会修改应用的签名吗，会导致应用升级时因签名不一致而无法更新吗？

• 不会，应用升级的签名由开发者决定，只要本地签名的密钥库文件（.p12）未发生变化，升级时签名就不会改变。

f. 更换发布证书会导致应用更新版本失败吗？

• 更换证书不会导致应用更新失败，但前提是证书是通过同一个CSR文件生成的，即需要确保密钥库文件（.p12）不变。需要注意的是，更换证书需同时更新Profile文件。

4、关于调试设备

• 一个账号每年最多可注册100台设备，如需删除调试设备，可勾选一个或多个设备，点击“批量删除设备”，在弹出窗口中点击“确认”即可。设备在添加后一年内被删除，该设备将置灰显示，如想重新添加一年内被删除的、置灰显示的设备，可通过单个添加设备的方式，重新编辑新的名称输入原UDID即可（注意：该设备注册时间依然是首次添加的时间为准）。

a. 如将手机设备类型选成了智能手表，是否会影响测试安装？

• 不影响，目前实际上不校验设备类型。

b. AGC设备列表界面的udid是否可以明文？

• 不可以，设备信息涉及隐私，后台UDID存储的时候是加密的。

5、鸿蒙单框架后续是否规划支持热修复计划？

• 后续暂无计划支持单框架热修复机制。

6、应用可以用上一个版本的versioncode和versionname上架吗？

• 版本大小只校验versionCode，可以提升versionCode而versionName不变。
• 如果更新版本versioncode要比之前的versioncode低会出现选不了对应的软件包。

7、关于测试应用

a. 邀请测试审核时间。

• 邀请测试是机审，一般是1-2小时完成，邀请测试不用备案信息，公开测试需要备案。

b. 邀请测试最多能允许多少个在架版本？

• 邀请测试最多允许3个版本同时在架，公开测试最多允许1个版本在架。所有测试版本数量不超过100个。
• 在架版本包括正在审核、等待生效、正在测试。

8、自动化上架api

相关api接口：

…

FAQ

关于发布应用相关FAQ可以参考发布应用-FAQ。

分发

1、发布企业内部应用

a. 发布企业内部应用是否可以用之前上架的账号？

• 不可以，必须准备一个未实名认证过的账号，目的是为避免权限冲突，需要与原企业账号之间进行权限隔离，故不可使用已实名认证的账号。

b. 企业分发无法进行关联认证（或者找不到关联认证入口）

• 这种一般先确认老的开发者账号信息是否为最新，如不是最新则需更新到最新并且通过审核后才可以发起关联认证。

c. 企业开发者（企业内部应用分发）实名认证申请指导文档

• 打款认证、人工审核实名认证、关联认证。
• 参考文档：企业开发者（企业内部应用分发）实名认证申请指导文档-申请指导。

d. 企业内部分发与应用市场分发能否保持包名不变？

• 为保证应用的唯一性，包名不能重复。

e. 企业内部分发的应用，能否通过应用市场安装？上架的应用，可以覆盖安装企业内部分发的应用么？

• 均不可以。

2、拉起应用市场详情页

• 参考文档：应用详情页展示。

3、按需加载

• 按需加载只支持.hap和.hsp包通过应用市场分发下载。
• 参考文档：产品特性按需分发(ArkTS)。

4、应用市场更新功能

• 参考文档：应用市场更新功能。

5、应用包体大小

• 包体大小跟以下几点均有关系：
  • 影响包体的因素较多，客户打包压缩，AG客户端显示是不压缩，应用加密与否，按需下载的能力等，比较复杂。
  • 比如按需下载动态库有关系，如果上传的包pad的hsp，手机上是不会下载的，加密文档也明确有提出加密后的应用相比不加密体积更大。
• 参考文档：应用加密-安全。

6、当前鸿蒙是否支持应用内下载安装应用？

• 鸿蒙不支持应用内下载安装应用，只能通过跳转应用市场，通过应用市场安装，当前系统分发策略是唯一分发策略，只能经过应用市场下载安装应用。

7、满足什么条件会出现在应用市场的“下载并安装新版本”里？

• 有老版本应用安装了且上架了应用新的版本。

8、邀请测试下载成功，安装失败

• 一般都是本地安装了旧版本，旧版本又是伙伴自己本地调试安装上去的，由于证书不匹配造成如果都是AG正常下载更新应该不会有问题，所以一般都是让伙伴把本地的应用先清理干净。
• 如还有问题，建议让伙伴收集日志，联系开发定位。
• 应用市场里面提交下应用市场日志，方法：打开应用市场 -> 我的 -> 帮助与客服 -> 问题与建议 ，输入任意问题描述，必须勾选共享应用日志，点击提交。

9、AGC报表和AG详情页里面的安装数量对比

• AGC界面的安装成功次数，是包含首次下载，卸载后下载，更新下载的。
• AG详情页：只会包含应用首次下载，或者预装应用首次更新下载，会按照华为账号去重。所以AG的详情页数据比AGC界面看到的安装量少。
• 两边的口径不一样，不能对等。

指标说明

10、低版本rom安装高版本的应用

• 一般会有系统弹框提示，该版本可能与系统不兼容，建议更新系统版本，否则可能会出现问题（比如闪退等现象）（如果系统版本没有最新的会出现图1，如果系统版本有更新的会出现图2）。

11、APP已上线是否有https下载链接

• https://appgallery.huawei.com/app/detail?id=<包名>跳转AG应用详情页下载。（应用市场详情页右上角也有分享链接按钮）。

12、应用间跳转方案如何选择？

13、当前系统有哪些应用分发方式？异同点有哪些？