纯血鸿蒙应用调试证书申请与签名全流程

本文详细梳理纯血鸿蒙（HarmonyOS）应用调试阶段的证书申请、设备注册、Profile配置及手动签名全流程，帮助开发者快速完成调试环境搭建。

一、调试证书申请

官方文档参考

申请调试证书

操作步骤

1. 登录华为开发者联盟后台：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html，进入「证书、APP ID和Profile」模块。

2. 左侧导航栏选择「证书、APP ID和Profile > 证书」，在证书页面点击「新增证书」。
   

3. 填写证书基础信息，重点上传证书请求文件（CSR）：

   • CSR文件可通过DevEco Studio生成（参考上述官方文档）；
     

4. 提交申请后，在证书列表页面查看已生成的调试证书，点击「下载」保存至本地（格式为.cer），供后续签名使用。
   

二、调试设备注册

官方文档参考

注册调试设备

操作步骤

1. 登录上述华为开发者联盟后台，进入「证书、APP ID和Profile > 设备」页面。
   

2. 单个设备添加：点击右上角「添加设备」，填写设备信息（核心为设备UUID）；

   • UUID获取命令：hdc shell bm get --udid（需先通过HDCS连接设备）。
     

3. 提交后等待审核，审核通过的设备将纳入调试设备白名单。

三、调试Profile申请

官方文档参考

申请调试Profile

操作步骤

1. 登录开发者后台，进入「证书、APP ID和Profile > Profile」页面，点击右上角「添加」。
   

2. 填写必填信息：应用名称、Profile名称，关联已申请的调试证书和已注册的调试设备；
   

3. 权限配置：根据应用实际需求勾选对应权限（参考权限配置参考图）；
   

4. 提交生成后，下载Profile文件（格式为.p7b）。

四、手动签名配置（DevEco Studio）

官方文档参考

手动签名

操作步骤

1. 打开DevEco Studio，进入「File > Project Structure > Project > Signing Configs」窗口；
2. 取消勾选「Automatically generate signature」（自动生成签名）和「Associate with registered application」（关联已注册应用）；
3. 手动配置签名文件路径：
   • 密钥文件（.p12）：选择本地生成/保存的p12密钥文件；
   • Profile文件（.p7b）：选择上述下载的调试Profile文件；
   • 数字证书（.cer）：选择下载的调试证书文件；
4. 特殊问题处理：
   • 若提示.p12文件密码错误，需确认登录的华为账号与证书申请账号一致，并清除证书同级目录下的material文件夹（原有配置缓存）；
5. 配置验证：
   • 点击「Apply」保存配置后，将鼠标悬停至配置项旁的问号图标，可查看证书有效期、应用包名、组织名称、权限列表等信息，信息完整则说明配置成功。
     
     

总结

1. 调试证书申请核心是准备CSR文件，企业级场景可直接使用共享目录下的统一CSR；
2. 设备UUID需通过hdc命令获取，且设备必须注册后才能进行调试签名；
3. 手动签名需取消自动生成选项，配置.p12/.p7b/.cer三类文件，密码错误时清理material缓存并核对账号。