一、证书类型说明

二、准备工作

1. 注册华为开发者账号

地址：https://developer.huawei.com

完成实名认证（个人/企业）

2. 创建应用

进入 AppGallery Connect

创建项目 → 添加应用

记录 包名（Bundle ID）

三、生成签名证书（完整流程）

步骤1：生成密钥库文件（.p12）

方式A：使用 keytool 命令

# 生成密钥库
keytool -genkeypair -alias "mykey" -keyalg EC -sigalg SHA256withECDSA \
  -dname "CN=你的名字,OU=部门,O=公司,L=城市,ST=省份,C=CN" \
  -keystore harmony.p12 -storetype pkcs12 \
  -storepass 123456 -keypass 123456 -validity 36500

# 参数说明：
# -alias: 密钥别名
# -keyalg EC: 使用椭圆曲线算法（鸿蒙要求）
# -sigalg SHA256withECDSA: 签名算法
# -keystore: 输出文件名
# -storepass: 密钥库密码
# -keypass: 密钥密码
# -validity: 有效期（天）

方式B：使用 DevEco Studio

打开 DevEco Studio

Build → Generate Key and CSR

填写信息，生成 .p12 文件

步骤2：生成证书请求文件（.csr）

# 从密钥库生成 CSR
keytool -certreq -alias "mykey" -keystore harmony.p12 \
  -storetype pkcs12 -file harmony.csr

或在 DevEco Studio 中同时生成。

步骤3：在 AppGallery Connect 申请证书

登录 AppGallery Connect

用户与访问 → 证书管理

点击「新增证书」

上传 .csr 文件

选择证书类型（调试/发布）

下载生成的 .cer 证书文件

步骤4：申请 Profile 文件

AppGallery Connect → 证书管理 → Profile管理

点击「添加」

选择：

类型：调试/发布

证书：选择刚才的证书

设备：调试证书需要添加测试设备UDID

应用：选择你的应用

下载 .p7b 文件

四、配置签名（uni-app 项目）

manifest.json 配置

{
  "app-harmony": {
    "signingConfigs": {
      "debug": {
        "storeFile": "harmony/debug.p12",
        "storePassword": "123456",
        "keyAlias": "mykey",
        "keyPassword": "123456",
        "signAlg": "SHA256withECDSA",
        "profile": "harmony/debug.p7b",
        "certpath": "harmony/debug.cer"
      },
      "release": {
        "storeFile": "harmony/release.p12",
        "storePassword": "your_password",
        "keyAlias": "mykey",
        "keyPassword": "your_password",
        "signAlg": "SHA256withECDSA",
        "profile": "harmony/release.p7b",
        "certpath": "harmony/release.cer"
      }
    }
  }
}

文件目录结构

项目根目录/
├── harmony/
│   ├── debug.p12      # 调试密钥库
│   ├── debug.cer      # 调试证书
│   ├── debug.p7b      # 调试Profile
│   ├── release.p12    # 发布密钥库
│   ├── release.cer    # 发布证书
│   └── release.p7b    # 发布Profile
└── manifest.json

五、DevEco Studio 配置

build-profile.json5

{
  "app": {
    "signingConfigs": [
      {
        "name": "debug",
        "type": "HarmonyOS",
        "material": {
          "storePassword": "123456",
          "certpath": "harmony/debug.cer",
          "keyAlias": "mykey",
          "keyPassword": "123456",
          "profile": "harmony/debug.p7b",
          "signAlg": "SHA256withECDSA",
          "storeFile": "harmony/debug.p12"
        }
      },
      {
        "name": "release",
        "type": "HarmonyOS",
        "material": {
          "storePassword": "your_password",
          "certpath": "harmony/release.cer",
          "keyAlias": "mykey",
          "keyPassword": "your_password",
          "profile": "harmony/release.p7b",
          "signAlg": "SHA256withECDSA",
          "storeFile": "harmony/release.p12"
        }
      }
    ]
  }
}

六、获取设备 UDID（调试证书需要）

方式1：DevEco Studio

连接设备

工具栏显示设备信息

复制 UDID

方式2：命令行

hdc shell bm get --udid

方式3：设备上查看

设置 → 关于手机 → 状态信息 → 设备标识

七、常见问题

Q1：签名验证失败？

检查清单：

□ .p12、.cer、.p7b 三个文件是否匹配 □ 密码是否正确 □ 包名是否与 Profile 中一致 □ 调试证书是否添加了设备 UDID

Q2：证书过期怎么办？

重新生成 CSR → 申请新证书 → 更新 Profile → 重新打包

Q3：换电脑开发怎么办？

把以下文件拷贝到新电脑：

.p12 密钥库文件 .cer 证书文件 .p7b Profile 文件

Q4：发布证书和调试证书的区别？

八、安全建议

密码管理

1. 不要把密码写在代码里
2. 使用环境变量或配置文件
3. .p12 文件不要提交到 Git

.gitignore 配置

# 签名文件
harmony/*.p12
harmony/*.cer
harmony/*.p7b

# 或整个目录
harmony/

环境变量方式

# 设置环境变量
export HARMONY_STORE_PASSWORD=your_password
export HARMONY_KEY_PASSWORD=your_password

// 配置中引用
{
  "storePassword": "${HARMONY_STORE_PASSWORD}",
  "keyPassword": "${HARMONY_KEY_PASSWORD}"
}

九、快速操作清单

□ 1. 注册华为开发者账号并实名认证 □ 2. 在 AppGallery Connect 创建应用 □ 3. 生成 .p12 密钥库文件 □ 4. 生成 .csr 证书请求文件 □ 5. 上传 CSR 申请证书，下载 .cer □ 6. 申请 Profile，下载 .p7b □ 7. 配置 manifest.json 或 build-profile.json5 □ 8. 打包测试

一句话：生成 .p12 → 导出 .csr → 申请 .cer 和 .p7b → 配置到项目 → 打包。