HarmonyOS鸿蒙Next应用上架全攻略（含常见问题）

HarmonyOS鸿蒙Next应用上架全攻略（含常见问题） 开发应用
使用 HUAWEI DevEco Studio 完成鸿蒙应用的开发。详细的开发过程可以参考 HarmonyOS 开发文档。

这部分由开发者自行完成。

创建应用
鸿蒙应用开发好后，不管是调试还是发布应用，首先都需要在 AGC 创建鸿蒙应用。当前鸿蒙应用创建是受邀名单管控。

根据开发者账号状态，创建应用方式不同。

如果想申请申请鸿蒙应用受邀名单，可参考下文开发者已实名章节。

开发者未实名

1. 登录 AGC 会提示如下页面，点击“去体验”后跳转到“项目设置 > HarmonyOS 应用 > 管理 HAP Provision Profile”页面：

2. 点击“HarmonyOS 应用”，在“添加应用”窗口中进行 HarmonyOS 应用创建。

开发者已实名

1. 如果已经申请鸿蒙应用受邀名单，AGC 页面“我的应用”下会出现“HarmonyOS 应用”页签。

选中“HarmonyOS 应用”，即可创建鸿蒙应用，具体参见直接创建应用。也可以在“我的项目”下添加创建鸿蒙应用，具体参见在项目下添加应用。

1. 如果未申请鸿蒙应用受邀名单，则只能在“我的项目”下添加创建鸿蒙应用。也只能进行应用的调试，无法发布应用。

如您需加入受邀名单，请将开发者名称、申请背景、支持设备类型及 Developer ID 发送至 agconnect@huawei.com，华为运营人员将在 1-3 个工作日内为您安排对接人员。Developer ID 查询方法请参见查询开发者帐号 ID 及项目 ID。

注意点：

• AGC 创建应用填写的包名必须全网唯一，鸿蒙应用包名也不能和安卓应用包名重复，如果提示包名被占用，需要更换包名。
• 直接创建鸿蒙应用不需要填写包名，通过上传的软件包自动解析。在项目下添加鸿蒙应用必须填写包名。
• 在项目下可以添加已有的应用，选择应用后不要修改应用名称，否则会认为是新建应用。

调测应用
鸿蒙应用开发完成后，且已经在 AGC 完成应用的创建，就可以开始进行调试了。如果仅仅在模拟器中调试，可以不配置签名信息；但如果需要在真机中调试，必须配置签名信息。华为提供了两种应用调试（签名）方法：自动化签名方式和手动签名方式。

自动签名
直接在开发工具 HUAWEI DevEco Studio 中完成自动化签名并调试，具体参见自动化签名。

注意点：

• 如果 IDE 没有自动签名选项，建议升级 IDE 至最新版本。自动签名特性仅在 DevEco Studio V2.1 Release 及更高版本中支持。
• 自动化签名的调试方式会自动在 AGC 中创建用于调试的数字证书和 Profile 文件，但当前 AGC 调试证书最多仅支持 2 个，即最多同时只支持为两个应用进行自动化调试，如已达到上限，需要在“用户与访问 > 证书管理”页面中“废除”多余的调试证书文件。
• 调试设备最多支持 100 个。
• 鸿蒙应用的 config.json 文件中的“bundleName”取值必须和 AGC 应用包名保持一致，如和包名冲突，可以修改 bundleName 进行规避。
• 如果报错连接 AGC 网站失败，请检查是否使用代理等，可以断开代理重试。

手动签名
通过登录 AGC 网站申请调试证书和调试 Profile 文件，下载到本地后再在 IDE 中进行签名，具体参见手动签名。

相关流程如下：

注意点：

• 本地调试一定要使用调试证书和调试 Profile 文件，并且调试证书和 Profile 文件要匹配。如果使用发布证书和发布 Profile 文件用于调试场景将会导致应用无法安装。
• 当前 AGC 调试证书最多仅支持 2 个，如已达到上限，需要在“用户与访问 > 证书管理”页面中“废除”多余的调试证书文件。
• 申请调试 Profile 文件的应用一定要和本地调试的应用匹配。

发布应用
本地调试完毕后，可以打包 HarmonyOS 应用，在 AGC 提交上架。

申请发布证书和发布 Profile 文件
为了确保 HarmonyOS 应用的完整性，HarmonyOS 通过数字证书和 Profile 文件来对应用进行管控。上架到华为应用市场的 HarmonyOS 应用也必须通过签名才允许上架。因此需要使用发布证书和 Profile 文件对应用进行签名后才能发布。具体操作参考申请应用发布证书和申请发布 Profile。

注意点：

• 当前 AGC 最多可申请 1 个发布证书；最多可申请 100 个 Profile 文件。
• 发布应用一定要使用发布证书和发布 Profile 文件，并且发布证书和 Profile 文件要匹配。如果使用调试证书和调试 Profile 文件用于发布场景将无法上传软件包。
• 申请发布 Profile 文件的应用一定要和发布应用匹配。

打包 HarmonyOS 应用
打包 HarmonyOS 应用主要是在 HUAWEI DevEco Studio 中配置好在 AGC 下载好的发布证书和发布 Profile，然后编译生成软件包。具体参考配置签名信息和编译构建 APP。

注意点：

• 最终打包上传的 HarmonyOS 应用软件包应为 .app 格式，且不能超过 2GB。否则，软件包将无法上传。
• 除了 .app 包外，AGC 还会解析检测 .app 包中的 .hap 包大小：运动手表 / 路由器类型的 hap 包大小不能超过 20MB，手机 / 智能手表 / 大屏类型的 hap 包大小不能超过 2GB。
• 免安装的 .hap 包不能超过 10MB。
• 编译 app 包所用的发布证书一定要使用 AGC 下载的证书，否则会导致上传软件包失败。

上架 HarmonyOS 应用
上架鸿蒙应用和上架安卓应用操作类似，主要是完善应用基本信息和版本相关信息填写，选择上传的软件包提交审核，等待审核通过后完成应用上架。具体参考配置应用信息和配置版本信息。

注意点：

• 上传的应用图标，截图，视频等需要满足应用市场要求，否则上传失败。
• 如果需要提前小范围测试应用，可以选择开放式测试版本发布。
• 上传素材或软件包需要纯公网环境，使用代理等需要断开连接。
• 升级应用时仅允许增加设备类型，不支持删除原有设备类型。如在架版本选择支持手机和大屏，升级应用必须保留手机和大屏设备，但可以新增支持手表设备。

上传软件包失败 FAQ

1. HarmonyOS 应用软件包上传后，提示“您上传的软件包使用的 HarmonyAppProvision 和证书不匹配，要求修改后再重新上传”，如何处理？

原因：HarmonyOS 应用软件包中的发布证书与发布 Profile 文件中的发布证书不匹配。

排查点：确认 IDE 打包时使用的发布证书是否与您申请发布 Profile 所使用的发布证书一致。

1. HarmonyOS 应用软件包上传后，提示“HarmonyOS hapAppProvision 文件非法，请重新上传”，如何处理？

原因：HarmonyOS 应用软件包中的发布 Profile 文件和当前上传软件包的应用不匹配。

排查点：确保软件包中使用的 Profile 文件是在当前应用下下载的。

常见错误场景是软件包中的 Profile 文件使用的是在 A 应用下下载的，但是却在 B 应用下上传软件包。

1. HarmonyOS 应用软件包上传后，提示“HarmonyOS 软件包内不同文件包名不一致，请重新上传”，如何处理？

原因：HarmonyOS 应用软件包内有 .hap 包的包名与发布 Profile 中的包名不一致。

排查点：确保 HarmonyOS 应用软件包内所有 .hap 包的包名一样，且与发布 Profile 中的包名一致。

1. HarmonyOS 应用软件包上传后，提示“软件包解析失败，请重新上传”，如何处理？

原因：可能是 IDE 编译出来的软件包有问题。

检查点：查看 .app 包里的 .hap 包数量和 pack.info 中设备数量是否一致。如果数量不一致，可以在 HUAWEI DevEco Studio 中 Clean Project 后重新编译打包。

1. HarmonyOS 应用软件包上传后，提示“您上传的 HarmonyOS 应用软件包使用的 HarmonyAppProvision 类型错误，请修改为发布类型后重新上传”，如何处理？

原因：软件包中使用的是调试证书和调试 Profile。

检查点：查看软件包使用的证书类型，正式上架应用市场请使用发布证书和发布 Profile。

1. HarmonyOS 应用软件包上传后，提示“非法软件包，请重新上传”，如何处理？

原因：可能是软件包未签名。

检查点：检查编译环境，是否使用了签名文件。或者是否有拆包再手动打包签名操作，未正确签名。