HarmonyOS：应用/元服务上架（1）

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤博客园地址：为敢技术（https://www.cnblogs.com/strengthen/ ）
➤GitHub地址：https://github.com/strengthen
➤原文地址：https://www.cnblogs.com/strengthen/p/18508754
➤如果链接不是为敢技术的博客园地址，则可能是爬取作者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

 

一、业务介绍

1、鸿蒙应用/元服务是华为提供的一种面向未来的服务形态，具有独立入口等特性，支持运行在多种设备上。在万物互联时代，为用户提供更丰富的入口、更精准的分发，助力开发者快速抢占流量入口。应用开发完成后，需要提交上架发布才能分发到应用市场、负一屏等多个渠道。

2、操作流程

（1）、在AppGallery Connect创建项目和应用，并申请发布所需的证书和Profile文件。

（2）、然后在DevEco Studio编译生成发布的软件包，在此过程中需要使用申请的发布证书和Profile，打包完成。

（3）、最后在AppGallery Connect提交上架申请。待审批通过，就可以分发到各个渠道。

二、创建项目和鸿蒙应用/元服务

1、创建项目：

（1）、登录AppGallery Connect：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/

（2）、选择【我的项目】

（3）、点击【添加项目】

（4）、输入项目名称后点击“创建并继续”，完成项目的创建。

2、添加鸿蒙应用/元服务。

在“项目设置”页面，点击“添加应用”，在弹出添加应用窗口，按提示完成相关信息填写。

（1）、“应用包名”需要和DevEco Studio中创建的工程时填写的“Bundle Name”值保持一致。

（2）、“是否元服务”需要和DevEco Studio中创建的鸿蒙应用类型保持一致（Application则选择：否，Atomic Service则选择：是）。 

三、申请数字证书和Profile

1、HarmonyOS通过数字证书与Profile文件等签名信息来保证鸿蒙应用/元服务的完整性，因此在上架前需要使用数字证书和Profile文件对鸿蒙应用/元服务进行签名后才能发布。

（1）、密钥：格式为.p12，包含非对称加密中使用的公钥和私钥。

（2）、证书请求文件：格式为.csr，包含开发者基本信息。

（3）、数字证书：格式为.cer，通过证书请求文件申请，有调试证书和发布证书两个类型。

（4）、Profile文件：格式为.p7b，包含鸿蒙应用/元服务的包名、数字证书信息、描述鸿蒙应用/元服务允许申请的证书权限列表等内容，每个鸿蒙应用/元服务包中必须包含一个Profile文件。

2、证书申请和签名流程：

 （1）、首先在DevEco Studio中通过密钥生成证书请求文件，然后通过证书请求文件申请发布证书。再通过发布证书申请发布Profile文件。最后再Dev

（2）、生成密钥和证书请求文件

在DevEco Studio中，选择【Build > Generate Key and CSR】，进入对应页面生成密钥和证书请求文件。

生成密钥文件：新生成或者选择已有的文件，密钥文件和密码需妥善保存，修改会导致签名发生变化。

注意：开发者需要自己填写保存文件的后缀.p12。

证书请求文件：选中密钥文件并按照要求填写开发者信息后，生成证书请求文件。别名和密码需妥善保存。

生成密钥文件、证书请求文件对应的密码务必妥善保存，一旦丢失修改，签名也会随之变化，将影响后续版本的升级更新。

点击【Next】,选择【CSR file(*.csr)】存储路径，注意要自己写后缀.csr，点击【Finish】，完成创建CSR文件。

注意：开发者需要自己填写保存文件的后缀.csr。

3、申请数字证书。

（1）、登录AppGallery Connect，选择【证书、APP ID和Profile】。

（2）、点击【新增证书】

输入【证书名称】，证书类型选择【发布证书】，上传证书请求文件（.csr），即第2步创建的CSR文件，点击【提交】。

（3）、证书申请成功后，点击【下载】将证书保存至本地。

4、申请Profile文件。

（1）、登录AppGallery Connect，选择【证书、APP ID和Profile】。

（2）、原HAP Provision Profile菜单已搬迁至证书、APP ID和Profile。

 （3）、点击右上角【添加】，在弹出的页面中，输入Profile名称，“类型”选择【发布】，选择上面申请的数字证书，选择需要申请的权限，如何申请ACL权限，需要和软件包中设置的权限保持一致。点击【添加】生成Profile文件。

（4）、Profile申请成功后，点击“下载”将Profile保保存至本地。

四、编译鸿蒙应用/元服务 

获取发布证书、发布Profile后就可以编译打包了。

1、配置签名信息：

（1）、打开DevEco项目工程，进入【File > Project Structure > Project > Signing Configs > default】界面。如果显示【Sign in】,则请进行登录。

（2）、 取消 “Automatically generate signature”勾选项，配置工程的签名信息。

【Store File】：密钥库文件，选择生成密钥和证书请求文件时生成的.p12文件。

【Profile file】：选择申请Profile文件时下载的.p7b文件。

【Certpath file】：选择申请数字证书时下载的.cer文件。

5、构建发布软件包

（1）、选择【Build > Build Hap（s）/APP（s）> Build APP(s)】，等待编译构建完成已签名的APP。

（2）、编译构建完成后，可以在工程目录【build＞outputs＞default】下，获取签名后的发布软件包。

五、上架鸿蒙应用/元服务

 AppGallery Connect提交上架申请。

1、测试版本：

在应用/元服务正式发布之前，可以向邀请用户发送开放式测试任务，开启小范围测试体验。

（1）、登录AppGallery Connect，点击【我的应用】。

（2）、在左侧导航栏选择“应用信息”菜单，完成应用的基本信息填写。

（3）、在【应用测试-版本列表】，可以新建测试的版本。

2、 在【软件包管理】菜单，上传编译签名后的软件包。

3、 全网发布：开放式测试没有问题，即可将版本全网发布。

（1）、选择“版本信息”下的“准备提交”。

（2）、在“版本信息”区域，点击“软件包管理”上传待全网发布的软件包。

（3）、完成其他信息填写后，点击“提交审核〞，审核通过后，该版本将发布至全网。

4、 分阶段发布：

全网发布后，下次升级版本时，可以采用分阶段发布，先向一定比例的用户发布更新的版本，再逐步提升用户比例，最终实现全网发布。通过小范围的版本更新，可以快速获取用户对新版本的反馈意见，降低全网发布后版本出现问题的风险。

1、选择已发布的版本，点击“升级”。

2、在“应用信息”页面，完成应用的基本信息填写，如语言、应用名称、应用介绍等。

3、选择“版本信息”下的“准备提交”。

4、在“应用上架”区域，点击“软件包管理”上传升级的软件包。

5、 “发布类型”选择“分阶段发布”，配置分阶段发布相关信息。

6、完成其他信息填写后，点击“提交审核”。

 六：审核标准：

为了保证鸿蒙应用和元服务的质量，华为会对已提交的应用和元服务进行审核，只有满足相关的审核要求才能在华为渠道分发。需要重点关注以下审核要素：

1、应用信息要完整：

应用名称、图标、介绍、截图、分类、语言、内容分级等信息要完整，且符合应用实际功能和用途，能够准确反映应用的核心体验。

2、应用安全要合规：

应用应提供用户可靠的使用环境，不得含有试图滥用网络、设备以及干扰其他应用的安全隐患，不得含有病毒、木马、欺骗用户、诱导等行为。

3、应用功能要稳定：

应用应给用户提供优质的使用体验，具有正常完整、稳定流畅、可实现、有吸引力的功能，不得含有影响用户体验的不合理功能，如应用频繁崩溃、卡顿等。

4、还需要关注应用内容、用户隐私、知识产权等其他要素，详细内容可参考《应用审核指南》。

元服务上架还需关注快照、卡片大小，以及外部跳转等要素，详细内容可参考《元服务审核指南》。

应用审核指南：

https://developer.huawei.com/consumer/cn/doc/app/50104

元服务审核指南：

https://developer.huawei.com/consumer/cn/doc/app/50129 

七、常见问题：

软件包解析错误说明：

https://developer.huawei.com/consumer/cn/doc/app/agc-help-harmonyoserror-0000001651912985

在提交上架时，一般在上传软件包时容易出现问题，下表罗列了常见的问题，更多问题可根据界面错误提示，参考《软件包解析错误说明》解决。

1	Profile文件非法	软件包中使用的发布Profile文件不是当前应用的。	确保软件包中使用的Profile文件是匹配当前发布的应用。 常见错误场景是软件包中的Profile文件使用的是在A应用的，但是却在B应用下上传软件包。
2	软件包使用的Profile和证书不匹配	软件包中的发布证书与发布Profile 文件中的发布证书不匹配。	确认DevEco Studio打包时使用的发布证书是否与申请发布Profil 文件时使用的发布证书一致。
3	非法软件包	软件包未签名。	检查编译环境，是否使用了签名文件，或者是否有拆包再手动打包签名操作，导致签名未正确，建议使用DveEco Studio中配置签名后，重新编译打包。
4	软件包中使用证书失效	软件包中使用的证书已被删除或 过期	检查证书列表中的证书是否存在，是否已超过失效日期。如果重新申请证书，需要重新编译新的软件包