鸿蒙应⽤上架全攻略（含常见问题）
开发应⽤
使⽤鸿蒙开发⼯具完成鸿蒙应⽤的开发。详细的开发过程可以参考。
这部分由开发者⾃⾏完成。
创建应⽤
根据开发者账号状态，创建应⽤⽅式不同。
如果想申请申请鸿蒙应⽤受邀名单，可参考下⽂开发者已实名章节。
开发者未实名
1.登录AGC会提⽰如下页⾯，点击“去体验”后跳转到“项⽬设置 > HarmonyOS应⽤ > 管理HAP Provision Profile”页⾯：
2.点击“HarmonyOS应⽤”，在“添加应⽤”窗⼝中进⾏HarmonyOS应⽤创建。
开发者已实名
1.如果已经申请鸿蒙应⽤受邀名单，AGC页⾯“我的应⽤”下会出现“HarmonyOS应⽤”页签。
选中“HarmonyOS应⽤”，即可创建鸿蒙应⽤，具体参见。也可以在“我的项⽬”下添加创建鸿蒙应⽤，具体参见。
2.如果未申请鸿蒙应⽤受邀名单，则只能在“我的项⽬”下添加创建鸿蒙应⽤。也只能进⾏应⽤的调试，⽆法发布应⽤。
如您需加⼊受邀名单，请将开发者名称、申请背景、⽀持设备类型及Developer ID发送⾄，华为运营⼈员将在1-3个⼯作⽇内为您安排对接⼈员。Developer ID。
注意点：
1.AGC创建应⽤填写的包名必须全⽹唯⼀，鸿蒙应⽤包名也不能和安卓应⽤包名重复，如果提⽰包名被占⽤，需要更换包名。
2.直接创建鸿蒙应⽤不需要填写包名，通过上传的软件包⾃动解析。在项⽬下添加鸿蒙应⽤必须填写包名。
3.在项⽬下可以添加已有的应⽤，选择应⽤后不要修改应⽤名称，否则会认为是新建应⽤。
调测应⽤
鸿蒙应⽤开发完成后，且已经在AGC完成应⽤的创建，就可以开始进⾏调试了。如果仅仅在模拟器中调试，可以不配置签名信息；但如果需要在真机中调试，必须配置签名信息。华为提供了两种应⽤调试（签名）⽅法：⾃动化签名⽅式和⼿动签名⽅式。
⾃动签名
直接在开发⼯具HUAWEI DevEco Studio中完成⾃动化签名并调试，具体参见。
注意点：
1.如果IDE没有⾃动签名选项，建议升级IDE⾄最新版本。⾃动签名特性仅在DevEco Studio V
2.1 Release及更⾼版本中⽀持。
2.⾃动化签名的调试⽅式会⾃动在AGC中创建⽤于调试的数字证书和Profile⽂件，但当前AGC调试证书最多仅⽀持2个，即最多同时只⽀持为两个应⽤进⾏⾃动化调试，如已达到上限，需要在“⽤户与访问 > 证书管理”页⾯中“废除”多余的调试证书⽂件。
3.调试设备最多⽀持100个。
4.鸿蒙应⽤的config.json⽂件中的“bundleName”取值必须和AGC应⽤包名保持⼀致，如包名冲突，可以修改bundleName进⾏规避。
5.如果报错连接AGC⽹站失败，请检查是否使⽤代理等，可以断开代理重试。
⼿动签名
通过登录AGC⽹站申请调试证书和调试Profile⽂件，下载到本地后再在IDE中进⾏签名，具体参见⼿动签名。
相关流程如下：
注意点：
1.本地调试⼀定要使⽤调试证书和调试Profile⽂件，并且调试证书和Profile⽂件要匹配。如果使⽤发布证书和发布Profile⽂件⽤于调试场景将会导致应⽤⽆法安装。
2.当前AGC调试证书最多仅⽀持2个，如已达到上限，需要在“⽤户与访问 > 证书管理”页⾯中“废除”多余的调试证书⽂件。
3.申请调试Profile⽂件的应⽤⼀定要和本地调试的应⽤匹配。
发布应⽤
本地调试完毕后，可以打包HarmonyOS应⽤，在AGC提交上架。
申请发布证书和发布Profile⽂件
为了确保HarmonyOS应⽤的完整性，HarmonyOS通过数字证书和Profile⽂件来对应⽤进⾏管控。上架到华为应⽤市场的HarmonyOS 应⽤也必须通过签名才允许上架。因此需要使⽤发布证书和Profile⽂件对应⽤进⾏签名后才能发布。具体操作参考和。
注意点：
1.当前AGC最多可申请1个发布证书；最多可申请100个Profile⽂件。
2.发布应⽤⼀定要使⽤发布证书和发布Profile⽂件，并且发布证书和Profile⽂件要匹配。如果使⽤调试证书和调试Profile⽂件⽤于发布场景将⽆法上传软件包。
3.申请发布Profile⽂件的应⽤⼀定要和发布应⽤匹配。
打包HarmonyOS应⽤
打包HarmonyOS应⽤主要是在HUAWEI DevEco Studio中配置好在AGC下载好的发布证书和发布Profile，然后编译⽣成软件包。具体参考和。
注意点：
1.上传的应⽤图标，截图，视频等需要满⾜应⽤市场要求，否则上传失败。
2.如果需要提前⼩范围测试应⽤，可以选择开放式测试版本发布。
3.上传素材或软件包需要纯公⽹环境，使⽤代理等需要断开连接。
4.升级应⽤时仅允许增加设备类型，不⽀持删除原有设备类型。如在架版本选择⽀持⼿机和⼤屏，升
级应⽤必须保留⼿机和⼤屏设备，但可以新增⽀持⼿表设备。
上传软件包失败F A Q
1.HarmonyOS应⽤软件包上传后，提⽰“您上传的软件包使⽤的HarmonyAppProvision和证书不匹配，要求修改后再重新上传”，如何处理？
原因：HarmonyOS应⽤软件包中的发布证书与发布Profile⽂件中的发布证书不匹配。
排查点：确认IDE打包时使⽤的发布证书是否与您申请发布Profile所使⽤的发布证书⼀致。
2.HarmonyOS应⽤软件包上传后，提⽰“HarmonyOS hapAppProvision⽂件⾮法，请重新上传”，如何处理？
原因：HarmonyOS应⽤软件包中的发布Profile⽂件和当前上传软件包的应⽤不匹配。
排查点：确保软件包中使⽤的Profile⽂件是在当前应⽤下下载的。
常见错误场景是软件包中的Profile⽂件使⽤的是在A应⽤下下载的，但是却在B应⽤下上传软件包。如下：
3.HarmonyOS应⽤软件包上传后，提⽰“HarmonyOS软件包内不同⽂件包名不⼀致，请重新上传”，如何处理？
升级鸿蒙原因：HarmonyOS应⽤软件包内有.hap包的包名与发布Profile中的包名不⼀致。
排查点：确保HarmonyOS应⽤软件包内所有.hap包的包名⼀样，且与发布Profile中的包名⼀致。
hap包名为config.json⽂件中的bundleame字段值：
4.HarmonyOS应⽤软件包上传后，提⽰“软件包解析失败，请重新上传”，如何处理？
原因：可能是IDE编译出来的软件包有问题。
检查点：查看.app包⾥的.hap包数量和pack.info中设备数量是否⼀致。如果数量不⼀致，可以在HUAWEI DevEco Studio中Clean Project后重新编译打包。
5.HarmonyOS应⽤软件包上传后，提⽰“您上传的HarmonyOS应⽤软件包使⽤的HarmonyAppProvision类型错误，请修改为发布类型后重新上传”，如何处理？
原因：软件包中使⽤的是调试证书和调试Profile。
检查点：查看软件包使⽤的证书类型，正式上架应⽤市场请使⽤发布证书和发布Profile。
6.HarmonyOS应⽤软件包上传后，提⽰“⾮法软件包，请重新上传”，如何处理？
原因：可能是软件包未签名。
检查点：检查编译环境，是否使⽤了签名⽂件。或者是否有拆包再⼿动打包签名操作，未正确签名。
发布评论