元服务签名配置的方式根据开发方式分为三种:DevEco Studio,命令行工具以及ASCF助手。
在DevEco studio中开发元服务配置签名可以参考:配置调试签名-编写与调试应用 - 华为HarmonyOS开发者。
在DevEco studio中配置release签名,需要新增一个signingConfigs配置,其"name"字段为"release"。
下面将主要介绍在使用命令行工具或者ASCF助手开发过程中如何配置签名。
元服务通过数字证书(.cer文件)和Profile文件(.p7b文件)来保证元服务的完整性。在申请数字证书和Profile文件前,需要生成密钥(存储在格式为.p12的密钥库文件中)和证书请求文件(.csr文件)。
基本概念
证书请求文件:格式为.csr,全称为Certificate Signing Request,包含密钥对中的公钥和通用名称、组织名称、组织单位等信息,用于向HarmonyOS 开发者中心申请数字证书。
Profile文件:格式为.p7b,包含元服务的包名、数字证书信息、描述元服务允许申请的证书权限列表,以及允许应用/元服务调试的设备列表(如果元服务类型为Release类型,则设备列表为空)等内容,每个元服务包中均必须包含一个Profile文件。
签名配置的主要流程为:生成密钥和证书请求文件 > 在HarmonyOS 开发者中心中申请和下载调试证书和Profile文件 > 配置签名信息。
生成密钥命令如下所示:
ascf generate-p12 --keyAlias <key-alias> --keystore <keystore-path> --keystorePwd <keystore-password> --keyPwd <key-password>
generate-p12 生成密钥
| 参数 | 支持的值 | 说明 |
|---|---|---|
| generate-p12 | - | 生成 P12 密钥命令 |
| --keyAlias | - | 密钥别名 |
| --keystore | - | 密钥库文件路径,文件后缀为.p12。 |
| --keystorePwd | - | 密钥库密码 |
| --keyPwd | - | 密钥密码 |
之后使用下面命令生成证书请求文件:
ascf generate-csr --keyAlias <key-alias> --keystore <keystore-path> --keystorePwd <keystore-password> --keyPwd <key-password> --outFile <output-csr-path>
generate-csr 生成 CSR 证书请求
| 参数 | 支持的值 | 说明 |
|---|---|---|
| generate-csr | - | 生成 CSR 证书请求命令 |
| --keyAlias | - | 密钥别名 |
| --keystore | - | 密钥库文件路径 |
| --keystorePwd | - | 密钥库密码 |
| --keyPwd | - | 密钥密码 |
| --outFile | - | 输出 CSR 文件路径,文件后缀为.csr。 |
在元服务项目中点击元服务图标
显示开发者主页,点击签名配置,如下图所示:

点击
,如下图所示,填入对应信息,点击“下一步”,即可生成或者使用已有的密钥。

如下图所示,填入对应信息后点击“完成”,即可生成证书请求文件。

登录HarmonyOS 开发者中心,选择“开发者管理”。
在左侧导航栏选择“ID、证书和Profile > 证书”,进入“证书”页面,点击“新增证书”。

在弹出的“新增证书”窗口填写要申请的证书信息,点击“提交”。

| 参数 | 说明 |
|---|---|
| 证书名称 | 自定义证书名称,不超过100个字符。 |
| 证书类型 | 选择“调试证书”。 |
| 选取证书请求文件(CSR) | 上传准备好的证书请求文件。 |
证书申请成功后,“证书”页面展示证书名称等信息。点击“下载”,将生成的证书保存至本地,供后续调试签名使用。
