开发应用
使用鸿蒙开发工具HUAWEI DevEco Studio完成鸿蒙应用的开发。详细的开发过程可以参考HarmonyOS开发文档。
这部分由开发者自行完成。
创建应用
鸿蒙应用开发好后,不管是调试还是发布应用,首先都需要在AGC创建鸿蒙应用。当前鸿蒙应用创建是受邀名单管控。
根据开发者账号状态,创建应用方式不同。
如果想申请申请鸿蒙应用受邀名单,可参考下文开发者已实名章节。
开发者未实名
1.登录AGC会提示如下页面,点击“去体验”后跳转到“项目设置 > HarmonyOS应用 > 管理HAP Provision Profile”页面:
2.点击“HarmonyOS应用”,在“添加应用”窗口中进行HarmonyOS应用创建。
开发者已实名
1.如果已经申请鸿蒙应用受邀名单,AGC页面“我的应用”下会出现“HarmonyOS应用”页签。
选中“HarmonyOS应用”,即可创建鸿蒙应用,具体参见直接创建应用。也可以在“我的项目”下添加创建鸿蒙应用,具体参见在项目下添加应用。
2.如果未申请鸿蒙应用受邀名单,则只能在“我的项目”下添加创建鸿蒙应用。也只能进行应用的调试,无法发布应用。
如您需加入受邀名单,请将开发者名称、申请背景、支持设备类型及Developer ID发送至[email protected],华为运营人员将在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