鸿蒙NEXT版实战开发：如何使用手动生成证书打包

往期鸿蒙全套实战文章必看：（附带鸿蒙全栈学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

如何使用手动生成证书打包

操作步骤：

1. 生成密钥和和证书请求文件。

   在申请数字证书和Profile文件前，首先需要通过DevEco Studio来生成密钥和证书请求文件。

   • 密钥：包含非对称加密中使用的公钥和私钥，存储在密钥库文件中，格式为.p12，公钥和私钥对用于数字签名和验证。
   • 证书请求文件：格式为.csr，全称为Certificate Signing Request，包含密钥对中的公钥和公共名称、组织名称、组织单位等信息，用于向AGC申请数字证书。
   1. 在顶部菜单栏选择“Build > Generate Key and CSR”。
   2. 点击“Choose Existing”，选择已有的密钥库文件（存储有密钥的.p12文件），跳转至步骤d继续配置；如果没有密钥库文件，点击“New”，跳转至步骤c进行创建。

      

   3. 在“Create Key Store”界面，填写密钥库信息后，点击“OK”。
      • Key store file：设置密钥库文件存储路径，并填写p12文件名。
      • Password：设置密钥库密码，必须由大写字母、小写字母、数字和特殊符号中的两种以上字符的组合，长度至少为8位。请记住该密码，后续签名配置需要使用。
      • Confirm password：再次输入密钥库密码。

      

   4. 在“Generate Key and CSR”界面继续填写密钥信息后，点击“Next”。
      • Alias：密钥的别名信息，用于标识密钥名称。请记住该别名，后续签名配置需要使用。
      • Password：密钥对应的密码，与密钥库密码保持一致，无需手动输入。
      • Validity：证书有效期，建议设置为25年及以上，覆盖应用/元服务的完整生命周期。
      • Certificate：输入证书基本信息，如组织、城市或地区、国家码等。

      

   5. 在“Generate Key and CSR”界面设置CSR文件存储路径和CSR文件名，点击“Finish”。

      

      CSR文件创建成功后，将在存储路径下获取生成密钥库文件（.p12）和证书请求文件（.csr）。

      

2. 申请调试证书，调试证书是为HarmonyOS应用/元服务配置签名信息的数字证书，可保障软件代码完整性和发布者身份真实性。证书格式为.cer，包含公钥、证书指纹等信息。
   1. 登录AppGallery Connect，选择“用户与访问”。

      

   2. 在左侧导航栏选择“证书管理”，进入证书管理页面，点击“新增证书”。

      

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

      

   4. 证书申请成功后，证书管理页面展示证书名称、证书类型和失效日期。点击“下载”，将生成的证书保存至本地，供后续签名使用。

      

3. 注册调试设备。
   1. 登录AppGallery Connect，选择“用户与访问”。
   2. 在左侧导航栏选择“设备管理”，进入设备管理页面。点击右上角的“添加设备”，在弹出窗口填写设备信息，完成后点击“提交”。

      

   3. 设备添加成功后，您可在“设备管理”页面查看各设备的名称、类型、UDID。

      

   4. 如需删除调试设备，勾选一个或多个设备，点击“批量删除设备”，在弹出窗口中点击“确认”即可。

      

4. 申请调试Profile。
   1. 登录AppGallery Connect，选择“我的项目”。
   2. 找到您的项目，点击您创建的HarmonyOS应用/元服务。
   3. 选择“HarmonyOS应用 > HAP Provision Profile管理”，进入“管理HAP Provision Profile”页面，点击右上角“添加”。

      

   4. 在弹出的“HarmonyAppProvision信息”窗口添加调试Profile，完成后点击“提交”。

      

   5. 调试Profile申请成功后，“管理HAP Provision Profile”页面展示Profile信息。点击“下载”，将生成的Profile保存至本地，供后续签名使用。

      

5. 手动配置签名信息。
   1. 打开DevEco Studio，在顶部菜单栏选择“File > Project Structure”，进入“Project Structure”界面。
   2. 导航选择“Project”，点击“Signing Configs”页签。去除勾选的“Automatically generate signature”（如果是API 8和9工程，需同时勾选“Support HarmonyOS”），填写相关信息后，点击“OK”。
      • Store File：密钥库文件，选择生成密钥和证书请求文件时生成的.p12文件。
      • Store Password：密钥库密码，需要与生成密钥和证书请求文件时设置的密钥库密码保持一致。
      • Key alias：密钥的别名信息，需要与生成密钥和证书请求文件时设置的别名保持一致。
      • Key password：密钥的密码，需要与生成密钥和证书请求文件时设置的密码保持一致。
      • Sign alg：固定设置为“SHA256withECDSA”。
      • Profile file：选择申请调试Profile时下载的.p7b文件。
      • Certpath file：选择申请调试证书时下载的.cer文件。

      

​