原子化 | APP开发

APP上架华为商店发布HarmonyOS原子化服务

原子化服务调试完毕后，您便可以将服务进行正式打包，在AGC提交上架。

HarmonyOS通过数字证书与Profile文件等签名信息来保证原子化服务的完整性，原子化服务如需上架则必须通过签名校验。因此，您需要使用发布证书和Profile文件对原子化服务进行签名后才能发布。

上架成功后，原子化服务将以服务卡片的形式展示在服务中心，用户可在服务中心搜索获取您的HarmonyOS原子化服务卡片。

操作流程

前提条件

您的开发者帐号已实名认证。
已在AGC创建HarmonyOS原子化服务。
已通过IDE生成证书请求文件（CSR）。
HarmonyOS原子化服务已完成开发与调试。

申请发布证书

说明

您最多仅可申请1个发布证书。

登录AppGallery Connect，选择“用户与访问”。
在左侧导航栏点击“证书管理”，进入“证书管理”页面，点击“新增证书”。
在弹出的“新增证书”窗口填写要申请的证书信息，点击“提交”。参数说明证书名称不超过100个字符。证书类型选择“发布证书”。上传证书请求文件（CSR）上传已生成的证书请求文件（CSR）。
证书申请成功后，“证书管理”页面展示证书名称、证书类型和失效日期。
- 点击“下载”，可下载证书。
- 如证书已过期或无需再使用，点击“废除”即可删除。

申请发布Profile

说明

您最多可申请100个Profile文件。

登录AppGallery Connect，选择“我的项目”。
找到您的项目，点击您创建的HarmonyOS原子化服务。
在左侧导航栏选择“HarmonyOS应用 > HAP Provision Profile管理”，进入“管理HAP Provision Profile”页面，点击右上角“添加”。
在弹出的“HarmonyAppProvision信息”窗口中添加Profile。参数说明名称不超过100字符。类型选择“发布”。选择证书点击“选择”，选择申请发布证书中生成的证书。说明升级服务时，您可以选择当前在架服务的发布证书，以继承已上架服务的数据与权限。申请受限权限若软件包因特殊场景要求使用受限权限，如读取、添加、移除或更改联系人数据等，请您务必在此处进行申请，否则您的服务将在审核时被驳回。点击“选择”，勾选需要申请的权限，点击“确定”即可。
发布Profile申请成功后，“管理HAP Provision Profile”页面展示Profile名称、Profile类型、添加的证书、状态（默认为“生效”）、更新时间（即审核通过时间）和失效日期。
- 点击“删除”，在确认框中点击“确认”，可删除Profile文件。
- 点击“下载”，可下载Profile文件。
- 点击“查看”，可了解Profile关联的包名、选择的受限权限等更多信息。

打包HarmonyOS原子化服务

软件包规范

最终打包生成的APP包需符合如下规范。

规范	说明
APP包大小	不超过2GB。
HAP包大小	原子化服务由一个或多个HAP包组成，每个HAP包不得超过10MB，以提供秒开体验。
APP包名	包名必须为以点号（.）分隔的字符串，且至少包含三段，每段中仅允许使用英文字母、数字、下划线（_），如“harmony_11.huawei.com ”。首段以英文字母开头，非首段以数字或英文字母开头，每一段以数字或者英文字母结束，如“harmony99.huawei.11_com”。不允许多个点号（.）连续出现，如“harmony..huawei.com ”。包名不超过128个字符，且不可包含敏感词或保留字符。保留字符包括如下：.oh..ohos..harmony..harmonyos..openharmony..system.

操作步骤

在正式打包原子化服务前，请先详细了解原子化服务软件包规范。
下载发布证书和发布Profile，方法可分别参考申请发布证书和申请发布Profile。
在DevEco Studio中，使用发布证书、发布证书对应的私钥文件以及发布Profile配置工程的签名信息，并编译构建APP。

上架HarmonyOS原子化服务

配置服务信息

登录AppGallery Connect，选择“我的应用”。
在应用列表首页中点击“HarmonyOS应用”页签。
点击待发布的原子化服务名称，进入“应用信息”页面。
如果您尚未签署华为HarmonyOS服务开放平台合作协议，此时会弹出华为HarmonyOS服务开放平台合作协议对话框，您需按提示进行协议签署。否则，页面将跳转回AGC首页，您将无法继续发布HarmonyOS原子化服务。注意只有帐号持有者和法务角色才有权限签署华为HarmonyOS服务开放平台合作协议。
在“应用信息”页面配置原子化服务的“基本信息”，具体要求如下表。参数说明支持设备默认显示创建原子化服务时选择的设备类型。
- 在“设备类型”栏，可新增或减少分发设备。注意
  - 支持由单设备改为多设备，或多设备改为单设备。
  - 升级服务仅允许增加设备类型，不支持删除原有在架服务已选择的设备类型。例如，在架服务支持的设备类型为“手机”，升级时您无法取消勾选“手机”选项。
- 在“可兼容设备”栏中，点击下拉箭头，可根据需要选择兼容设备。
  - 手机：可选择手机、平板。
  - 大屏：可选择智慧屏。
  - 手表：可选择智能手表、运动手表。
- 在“可支持操作设备”栏中，点击下拉箭头，可根据需要选择支持的操作设备。
  - 手机：无。
  - 大屏：可选择遥控器、手柄。
  - 手表：无。
- 在“操作”栏中，点击“清除”，可一键清除所选的兼容设备与支持的操作设备。
说明路由器设备不支持设置兼容设备和操作设备。
配置原子化服务的“可本地化基础信息”，详情请参见配置可本地化基础信息。说明
- 运动手表和智能手表共用一套应用素材。
- 如果选择分发到多设备，请在各设备标签页分别上传对应的应用素材。
配置原子化服务的“应用分类”，详情请参见设置应用分类。
配置原子化服务的“开发者服务信息”，详情请参见配置开发者服务信息。
配置完成后点击“下一步”，在弹窗中点击“确认”，进入“准备提交”页面，开始设置版本信息。

配置版本信息

配置原子化服务的发布国家或地区，目前仅支持发布到中国大陆地区。
设置是否为开放式测试版本。注意当前原子化服务的开放式测试仅支持手机、平板、大屏、智能手表。如果您在创建服务时设备类型选择了路由器设备，将不展示此选项。目前，HarmonyOS原子化服务仅支持在中国大陆地区进行开放式测试。
- 正式发布的版本请选择“否”。
- 如您想发布为开放式测试版本，选择“是”，具体配置请参见开放式测试操作指南。
在“软件版本”下点击“软件包管理”后，在弹窗中点击“上传”。
在“上传包”窗口中点击“+”，上传原子化服务的软件包。上传前请确保软件包满足以下要求：
- 软件包需满足格式和大小限制，否则系统将提示错误。软件包格式和大小限制等请参见软件包规范。
- 请确保您上传的软件包支持所选的分发设备。否则，点击“保存”或“提交审核”时，系统将提示错误，您需要重新上传软件包或修改支持设备。如您选择分发到路由器设备，则只能重新上传软件包，无法修改支持设备。
- 请确保您上传的软件包签名与发布证书匹配，否则系统将提示错误，您需要重新上传。
上传成功后，您可在“软件包管理”窗口中执行如下操作：
- 点击文件名称下，查看软件包详细信息，如包名、SHA256、软件大小。请确认软件包信息与您需要发布的版本一致。
- 点击“操作”栏的“调试”或“测试”链接，对软件包分别进行云调试或云测试，可及早发现并解决问题，提高服务审核通过率。具体操作请参考云测试和云调试操作指南。
配置原子化服务的“付费情况”和“应用内资费”，详情请参见设置应用付费情况。注意当前AGC仅支持发布免费使用的原子化服务。
配置原子化服务的“内容分级”，详情请参见设置内容分级。
如果涉及以下两种场景，请填写原子化服务的“应用隐私说明”，否则直接进行下一步。
- 如检测到软件包涉及获取敏感隐私权限，您需为每个敏感权限项填写相应的权限说明，每条权限说明最大支持500字符。
- 如检测到软件包涉及获取受限权限，您需为每个受限权限项填写相应的权限说明，并上传视频说明使用场景。
  - 权限说明：每条权限说明最大支持500字符。
  - 使用场景视频：支持MOV或MP4格式，大小500MB以内。仅支持上传一个视频。
  注意如果您的软件包声明要求使用受限权限，请确保该权限在创建发布Profile时已经申请通过，否则您的服务上架审核将会被驳回。如您尚未申请，请重新申请发布Profile，然后重新上传软件包。
填写原子化服务的“隐私声明”，详情请参见填写隐私声明。
配置原子化服务的“版权信息”。
- 承诺函：必选。点击“承诺函”链接，仔细阅读合规承诺书后，勾选“我已阅读并同意《承诺函》”。
- 电子版权证书：可选。仅支持PDF格式，大小不超过5MB。请勿上传非PDF格式的文件或是将非PDF格式的文件的扩展名改为PDF。
- 应用版权证书或代理证书：可选。支持JPG、PNG、BMP格式的资质文件，单个图片最大不能超过15MB。
如原子化服务属于游戏类且支持设备包含手机或者路由器，请按要求填写游戏版号信息。
- 版号信息：必填，您需要向相关单位申请游戏版号，版号不超过512字符。
- 版号证明：必选，需上传“版号批文”或“版号授权书”，图片格式支持JPG、JPEG、PNG、PDF，不超过4MB。若您上传了版号授权书，还需填写“授权书有效期”。说明关于版权和版号的详细上传说明，请参考版权资质审核要求。
在“应用审核信息”栏，填写审核相关的信息。该部分信息仅会展示给审核人员查看。
- 您可在“备注”栏填写对审核过程会有所帮助的、有关您服务的额外信息，包括在测试中需要的特别设置等。
- 如审核过程涉及身份验证，还需提供测试帐号供华为审核人员完成服务中登录、查看、购买等功能的审核。
- 在“自测文件”栏，可上传docx或mp4格式的自测文件。最多可上传5个，docx文件不超过15MB，自测文件总大小不超过500MB。提交自测文件可有效提高审核通过率，如原子化服务需要与设备进行联动，则必须提交自测文件。
如选择分发到路由器设备，您还可设置是否勾选“必须联网才能使用”。勾选以后，用户在无网络环境下将无法正常使用该服务的核心功能，如即时通信、在线直播、网游等。
配置上架时间。您可以选择“审核通过立即上架”，也可以选择“指定时间”。说明指定时间是您的本地时间。在您设置时间之后，系统会自动转换成UTC标准时间并显示在后面。
点击“提交审核”，在弹出的窗口中确认版本号无误后，点击“确认”。
提交成功后，在“版本信息”页面“状态”中可查看审核状态。注意对于HarmonyOS手机原子化服务，如果您是中国大陆的开发者，当您提交服务审核后，华为将对您的服务进行隐私合规检测。检测不通过可能会导致您的上架申请被驳回，请您及时关注版本信息界面的检测结果，并根据相关提示进行隐私整改。
对于配置为“指定时间”上架的服务，审核通过之后、指定上架时间到达之前，您可随时手动发布版本上线：在版本信息页面右上角点击“手动发布”，在确认提示框点击“确认”即可。手动发布一般在几分钟内生效。注意原子化服务成功发布后，AGC会对上架服务进行重签名，您原先的服务签名将被替换为新签名。