← 返回博客列表

鸿蒙真机调试CSR证书创建流程

Vic.Wang2026/09/28115 阅读0 喜欢最近更新 2026/09/28 11:32:21

本文发布时间较早,文中提及的技术方案与接口可能已经过时,请注意甄别参考。

最近在用 Uniapp X 弄鸿蒙APP,想在鸿蒙真机上装一下安装包试一下实际效果,然后提示要先创建证书,就记录下过程。

先注册一个华为开发者账号, https://developer.huawei.com/ ,然后找到 AppGallery Connect,也就是 AGC。

选择【证书、APP ID和Profile】,然后选择【证书】菜单,在右上角找到【新增证书】

image.png

新增证书:

image.png

一、使用 DevEco Studio IDE创建

image.png

image.png

image.png

二、使用命令行创建 CSR 证书

这里的CSR(证书请求文件)需要本地生成,在Mac终端执行两条命令(keytool 用 DevEco Studio 自带的 JBR):

1、生成密钥库 .p12(会让你设置密码和填名称/组织等):

/Applications/DevEco-Studio.app/Contents/jbr/Contents/Home/bin/keytool \
  -genkey -alias hongmeng_test -keyalg RSA -keysize 2048 \
  -sigalg SHA256withRSA -validity 36500 \
  -keystore ~/hongmeng_test.p12 -storetype pkcs12

image.png

按要求输入即可

2、导出 CSR 文件

/Applications/DevEco-Studio.app/Contents/jbr/Contents/Home/bin/keytool \
  -certreq -alias hongmeng_test \
  -keystore ~/hongmeng_test.p12 -storetype pkcs12 \
  -file ~/hongmeng_test.csr

然后在新增证书的弹窗里面选择刚刚导出的 ~/hongmeng_test.csr 提交即可。

第 1 步设置的密码和别名(hongmeng_test)务必记牢,后续打包签名、配置 profile 时要用同一套 .p12 信息,丢了就得重新走一遍。

证书名称随便填,类型选择「调试证书」,调试证书有效期内可用,过期后需要重新申请。

三、使用命令行删除证书

如果你忘记了密码,keystore(.p12)的密码是无法找回的,因为它是本地加密保存,忘记就只能丢弃重建。

# 先确认你之前生成的文件路径,例如:
ls -la ~/hongmeng_test.p12 ~/picset_test.csr

# 删除(移到废纸篓,非直接 rm)
osascript -e 'tell app "Finder" to delete POSIX file "/Users/vic/hongmeng_test.p12"'
osascript -e 'tell app "Finder" to delete POSIX file "/Users/vic/hongmeng_test.csr"'

如果证书已经使用过了,还需要去 AGC(AppGallery Connect) 把相应的证书也删掉重建,不然以后签名会失败。

四、使用 HBuilderX 自动申请

如果你本来就是从 HbuilderX 「运行到鸿蒙」触发的证书配置,直接在弹窗里选自动申请调试证书,只填写包名即可,完全跳过手动创建 CSR 和 AGC 新增证书这一步。

image.png

参考资料: 申请调试证书

若有共鸣,不妨点个喜欢

本文地址:https://www.mingsixue.com/blog/detail/harmony-csr-create-flow

分享:微博QQ空间X