锐客网

  1. 首页 > it技术 > >

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

开发应用 使用鸿蒙开发工具HUAWEI DevEco Studio完成鸿蒙应用的开发。详细的开发过程可以参考HarmonyOS开发文档。
这部分由开发者自行完成。
创建应用 鸿蒙应用开发好后，不管是调试还是发布应用，首先都需要在AGC创建鸿蒙应用。当前鸿蒙应用创建是受邀名单管控。
根据开发者账号状态，创建应用方式不同。
鸿蒙应用上架全攻略（含常见问题）
文章图片

如果想申请申请鸿蒙应用受邀名单，可参考下文开发者已实名章节。
开发者未实名 1.登录AGC会提示如下页面，点击“去体验”后跳转到“项目设置 > HarmonyOS应用 > 管理HAP Provision Profile”页面：
2.点击“HarmonyOS应用”，在“添加应用”窗口中进行HarmonyOS应用创建。
开发者已实名 1.如果已经申请鸿蒙应用受邀名单，AGC页面“我的应用”下会出现“HarmonyOS应用”页签。
选中“HarmonyOS应用”，即可创建鸿蒙应用，具体参见直接创建应用。也可以在“我的项目”下添加创建鸿蒙应用，具体参见在项目下添加应用。
2.如果未申请鸿蒙应用受邀名单，则只能在“我的项目”下添加创建鸿蒙应用。也只能进行应用的调试，无法发布应用。
如您需加入受邀名单，请将开发者名称、申请背景、支持设备类型及Developer ID发送至agconnect@huawei.com，华为运营人员将在1-3个工作日内为您安排对接人员。Developer ID查询方法请参见查询开发者帐号ID及项目ID。

  • 注意点：
1.AGC创建应用填写的包名必须全网唯一，鸿蒙应用包名也不能和安卓应用包名重复，如果提示包名被占用，需要更换包名。
2.直接创建鸿蒙应用不需要填写包名，通过上传的软件包自动解析。在项目下添加鸿蒙应用必须填写包名。
3.在项目下可以添加已有的应用，选择应用后不要修改应用名称，否则会认为是新建应用。
调测应用 鸿蒙应用开发完成后，且已经在AGC完成应用的创建，就可以开始进行调试了。如果仅仅在模拟器中调试，可以不配置签名信息；但如果需要在真机中调试，必须配置签名信息。华为提供了两种应用调试（签名）方法：自动化签名方式和手动签名方式。
自动签名 直接在开发工具HUAWEI DevEco Studio中完成自动化签名并调试，具体参见自动化签名。
注意点： 1.如果IDE没有自动签名选项，建议升级IDE至最新版本。自动签名特性仅在DevEco Studio V2.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文件对应用进行签名后才能发布。具体操作参考申请应用发布证书和申请发布Profile。
注意点： 1.当前AGC最多可申请1个发布证书；最多可申请100个Profile文件。
2.发布应用一定要使用发布证书和发布Profile文件，并且发布证书和Profile文件要匹配。如果使用调试证书和调试Profile文件用于发布场景将无法上传软件包。
3.申请发布Profile文件的应用一定要和发布应用匹配。
打包HarmonyOS应用 打包HarmonyOS应用主要是在HUAWEI DevEco Studio中配置好在AGC下载好的发布证书和发布Profile，然后编译生成软件包。具体参考配置签名信息和编译构建APP。
注意点： 1.上传的应用图标，截图，视频等需要满足应用市场要求，否则上传失败。
2.如果需要提前小范围测试应用，可以选择开放式测试版本发布。
3.上传素材或软件包需要纯公网环境，使用代理等需要断开连接。
4.升级应用时仅允许增加设备类型，不支持删除原有设备类型。如在架版本选择支持手机和大屏，升级应用必须保留手机和大屏设备，但可以新增支持手表设备。
上传软件包失败FAQ 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应用软件包上传后，提示“非法软件包，请重新上传”，如何处理？
原因：可能是软件包未签名。
检查点：检查编译环境，是否使用了签名文件。或者是否有拆包再手动打包签名操作，未正确签名。
【鸿蒙应用上架全攻略（含常见问题）】更多精彩内容，请见华为开发者官方论坛→https://developer.huawei.com/consumer/cn/forum/home?ha_source=sanfang

    推荐阅读


    上一篇：Java架构|dubbo - 负载均衡调用过程

    下一篇：（为什么在 Spring 的配置里，最好不要配置 xsd 文件的版本号）