HarmonyOS 各厂商应用开通指南，新手教程

xzp19841203xzp

249人浏览 · 2026-11-08 14:57:20

xzp19841203xzp · 2026-11-08 14:57:20 发布

1. 生成手动签名文件并在工程中配置

HarmonyOS应用/服务通过数字证书（.cer文件）和Profile文件（.p7b文件）来保证应用/服务的完整性。在申请数字证书和Profile文件前，首先需要通过DevEco Studio来生成密钥（存储在格式为.p12的密钥库文件中）和证书请求文件（.csr文件）。然后，申请调试数字证书和调试Profile文件。最后，将密钥（.p12）文件、数字证书（.cer）文件和Profile（.p7b）文件配置到工程中。

参考华为鸿蒙官方开发文档，生成密钥和证书请求文件
参考华为鸿蒙官方开发文档，申请调试证书和调试Profile文件
将以上两个步骤生成的生成密钥文件（.p12）、证书请求文件(.ser)、调试（或发布）证书(.cer)、Profile文件(.p7b)文件保存在本地。
手动配置签名信息，参考华为鸿蒙官方文档，手动配置签名信息
在DevEco Studio中配置密钥（.p12）文件、申请的调试证书（.cer）文件和调试Profile（.p7b）文件。
在File > Project Structure > Project > Signing Configs窗口中，取消勾选“Automatically generate signature”（如果是HarmonyOS应用，请勾选“Support HarmonyOS”），然后配置工程的签名信息。
- Store File：选择密钥库文件，文件后缀为.p12，该文件为生成密钥和证书请求文件中生成的.p12文件。
- Store Password：输入密钥库密码，该密码与生成密钥和证书请求文件中填写的密钥库密码保持一致。
- Key Alias：输入密钥的别名信息，与生成密钥和证书请求文件中填写的别名保持一致。
- Key Password：输入密钥的密码，与生成密钥和证书请求文件中填写的Store Password保持一致。
- Sign Alg：签名算法，固定为SHA256withECDSA。
- Profile File：选择申请调试证书和调试Profile文件中生成的Profile文件，文件后缀为.p7b。
- Certpath File：选择申请调试证书和调试Profile文件中生成的数字证书文件，文件后缀为.cer。

harmony-9

配置完成后，进入工程级build-profile.json5文件，在“signingConfigs”下可查看到配置成功的签名信息。

harmony-10

配置完成后，进行真机运行，运行成功表示手动签名文件没有问题

2. 创建华为应用、开通推送服务、创建服务帐号密钥文件

参见华为官方文档配置AppGallery Connect ，完成文档中的内容配置。

登录 AppGallery Connect 网站，选择我的项目。打开刚才创建的项目，点击创建应用，如下图：
- 在 “添加应用” 页面中中选择“APP(HarmonyOS)”，填写应用参数。
点击左侧 “推送服务”选择相应的项目和应用，点击开通推送服务开通推送服务。

选择我的项目 打开您刚才创建的项目，然后选择您刚创建的鸿蒙应用，点击选择添加公钥指纹 (HarmonyOS API 9及以上)。
选择您刚才在1. 生成手动签名文件并在工程中配置步骤中创建的调试证书
在这里可以看到您刚才选择的证书文件的指纹信息

在 “项目设置 > 推送服务> 配置 > 选择应用” 中开通 “应用回执状态”，配置个推侧的回调地址。如下
- 回执名称可自定义
- 回调地址

https://thirdrcp-hz.getui.com/harmony/hw

- 点击“提交”，提示“成功”则表示配置成功
在 “项目设置 > 推送服务> 配置 > 选择应用” 中申请开通 “自分类权益”，并在服务端设置对应的消息分类参数，消息分类标准以及申请流程，详见鸿蒙消息分类标准。如下
创建服务帐号密钥文件，您在华为开发者联盟的API Console点击“创建”服务账号凭证

创建时注意：
- 选择您需要的项目（切记需要选择您开通鸿蒙推送应用的对应所属项目）
- 选择“app管理员”、“管理员”角色，必须选择
点击“生成公私钥”，公钥上传，私钥自己保存（注意：点击右上角确认按钮后浏览器会自动下载私钥.json文件到本地）
下载文件内容如下：（如有错误请检查生成服务账号秘钥生成流程）

3. 华为PUSH 集成配置

需完成上述 1. 生成手动签名文件并在工程中配置 和 2. 创建华为应用、开通推送服务、创建服务帐号密钥文件流程：
工程中配置Client ID：
- 登录AppGallery Connect网站，选择“我的项目”，在项目列表中找到您的项目，下拉页面至应用，获取应用的Client ID。
在项目模块级别下的src/main/module.json5（例如entry/src/main/module.json5）中，新增metadata并配置client_id，如下所示：

  "module": {
     "name": "entry",
     "type": "xxx",
     "description": "xxxx",
     "mainElement": "xxxx",
     "deviceTypes": [],
     "pages": "xxxx",
     "abilities": [],
      // 配置如下信息
     "metadata": [ 
       {
          "name": "client_id",
          // 配置为步骤1中获取的Client ID
          "value": "xxxxxx"  
       }
     ]
 }

集成验证(获取Push Token)：

导入pushService模块
建议在您的UIAbility（例如EntryAbility）的onCreate()方法中调用getToken()接口获取Push Token

import { pushService } from '@kit.PushKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
export default class EntryAbility extends UIAbility {
// 入参 want 与 launchParam 并未使用，为初始化项目时自带参数
async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): Promise<void> {
// 获取Push Token
  try {
    const pushToken: string = await pushService.getToken();
    hilog.info(0x0000, 'testTag', 'Get push token successfully: %{public}s', pushToken);
  } catch (err) {
    let e: BusinessError = err as BusinessError; hilog.error(0x0000, 'testTag', 'Get push token catch error: %{public}d %{public}s', e.code, e.message);
  }
}
}