从0到1上架一个元服务的全流程

2024-12-18 15:53:00

128次阅读

0个评论

鉴于现在官网对于发布元服务的整体流程没有一个很好的讲解，正好要上架一个元服务，所以就整理了一下相关的全流程，供大家参考。

整体流程主要分为如下几步：

1.创建项目
2.AppGallery处理
3.开发工作
4.编译打包
5.发布

接下来开始操作。

一、创建元服务项目

元服务项目的创建，跟普通鸿蒙项目的创建整体上略微有点差异，下面细说

1.DevEcoStudio 菜单栏选择 File -> New -> Create Project，然后选择 “Atomic Service”，有多种模板，默认会创建 Empty Ability，然后点击 Next

2.Next下一步的话，这块会校验账号登录状态，如果没有登录则需要跳转网页去登录一下

3.登录完毕后，回来DevEcoStudio，会要求选择你的元服务对应的 APPID，可以下拉选择，如果还没有话，需要去网页上创建，点击 “Register App ID”即可跳转去创建。参考下图：

4.跳转到这，填写你的元服务的信息，比如：应用名称、应用类型等等

5.第四步完成基础信息填写后，会要求二次确认，确认无误后，点击 确定 即可，会提示创建完成，此时可以跳转到控制台，查看当前项目的信息（看不看都行，暂时用不到）

控制台的基本信息展示

6.此时再回到 DevEco Studio ，从下拉列表中选择你刚才创建好的项目，如图所示进行回显。然后点击 Next 开始正式创建项目

7.接上，此处会要求填写项目基本信息。比如：Project Name, Bundle Name(会自动带出来，无需填写)，Save Location( 项目源码存放地址),然后继续点击 Finish 即可完成项目的创建

至此，第一步项目创建就算是完成了

二、AppGallery处理

这一步，其实已经融合进了第一步中，主要就是创建元服务项目的 App ID，以及控制台查看该项目的一些信息

三、开发工作

这一步，就是自己元服务功能的开发工作了，具体的不赘述，可以参考文档进行开发哈

四、编译打包

打包之前，需要先做一些AppGallery的配置，等于是对第二步的一些补充。

AppGallery的配置补充

HarmonyOS通过数字证书与Profile文件等签名信息来保证元服务的完整性，元服务上架到AppGallery Connect必须通过签名校验。因此，您需要使用发布证书和Profile文件对元服务进行签名后才能发布。完整打包流程如下图所示。

4.1 生成密钥和证书请求文件

1.菜单选择“Build > Generate Key and CSR”。

2.在 Generate Key and CSR弹窗中，按需填写基本信息

12 1

此时如果是第一次的话，应该是没有 p12 文件的，所以需要点 New去新建一个，如下图所示：

Key store file: 设置密钥库文件存储路径，起一个自定义的名字
Password：给这个密钥文件设置个密码，记住了，别忘了。。
Confirm Password：确认密码，跟上边的要一致

完事后点击 OK, 回到 Generate Key and CSR弹窗，此时会把你刚才新建的 p12 文件的路径给带出来，以及 Password 也会带出来并回显到弹窗中

如下图所示：

此时，还需要填写 Alias，就是起个别名，自己随便起一个能记住的就行了，至于下边的 Advance setting个人觉得没必要设置，都默认就行了，就是一些额外的配置信息而已

Alias：密钥的别名信息，用于标识密钥名称。请记住该别名，后续签名配置需要使用。
Password：密钥对应的密码，与密钥库密码保持一致，无需手动输入，自动回显带入。
Validity：证书有效期，建议设置为25年及以上，覆盖元服务的完整生命周期。
Certificate：输入证书基本信息，如组织、城市或地区、国家码等。

然后点击 Next 进入下一步。此处需要设置CSR文件存储路径和CSR文件名，点击 Finish ，如图所示

点击 Finish 之后，会弹窗提示你存储成功并回显路径信息，如下图所示

此时，密钥库文件（.p12）和证书请求文件（.csr）都已经生成完毕，并保存到你的电脑上了

4.2 申请发布证书

1.选择「证书、APP ID和Profile」入口进入，如图19
2.选择「证书」Tab，如图20
3.点击『新增证书』

图19

图20

4.新增证书弹窗：证书名称：自己填写一个证书名字（不超过100个字符。）
5.新增证书弹窗：证书类型：选择「发布证书」，如图21
6.新增证书弹窗：选取证书请求文件(CSR)：上传生成前边「密钥和证书请求文件」时获取的.csr文件。如图22

图21

图22

最后，点击 提交，就可以生成证书了

在证书管理界面，可以将当前证书下载到电脑上，点击 下载 按钮即可下载。如图23

4.3 申请发布Profile

Profile的格式是 .p7b，包含了项目的一些包名、证书之类的信息等等，是发布元服务（应用）必须的内容。

回到图20 所示位置，选择 Profile Tab项，点击右上角『添加』，如图24所示。

然后在界面中，填写基本信息如下：

应用名称：可以下拉列表选择，选择你前边创建的应用名称，如图25所示
包名：应用名称选完后会自动带出来的，无需填写
Profile名称：自定义，自己起一个名字，建议与元服务名称保持一致。如图25所示
类型：选择发布，如图25所示
选择证书：点击可以弹出一个列表，选择前边创建好的证书就行了。
申请权限：若软件包因特殊场景要求使用受限权限，如读取、添加、移除或更改联系人数据等，务必在此处进行申请，否则元服务将在审核时被驳回。如果没有，则可以不选。填完信息后，添加右上角「添加」就可以，然后回到 Profile 的列表页，就会出现你刚才添加的这个 Profile 项了。如图26所示

图25