UniappX不会运行到鸿蒙？超超超保姆级鸿蒙开发生成证书以及配置证书步骤

不爱说话郭德纲
409 阅读5分钟

前言

记录一下UniappX运行到鸿蒙的全过程，超超超细生成证书以及配置证书步骤

image.png

1.开发环境要求

  • 注册鸿蒙开发者账号，地址

  • HBuilderX 4.24+ 下载地址

  • DevEco Studio 下载地址

    • HBuilderX 4.24+ 要求 DevEco Studio 5.0.3.400+
    • HBuilderX 4.31+ 要求 DevEco Studio 5.0.3.800+。
    • HBuilderX 4.61+ 针对 uni-app x 项目要求 DevEco Studio 5.0.7.100+。
    • uni-app 项目要求鸿蒙系统版本 API 12 以上，uni-app x 项目要求鸿蒙系统版本 API 14 以上（DevEco Studio 有内置鸿蒙模拟器）

  • 点击下载 DevEco5.1.1Beta 版本，下载 API19 模拟器即可运行 uni-app 鸿蒙项目和元服务，除此之外的模拟器暂不支持。

2.在 HBuilderX 中设置鸿蒙运行配置

HBuilderX 依赖于 DevEco Studio 里面带的鸿蒙工具链，所以需要电脑已经安装了符合版本要求的 DevEco Studio。

打开 HBuilderX，点击上方菜单 - 工具 - 设置，再点击 运行配置，在鸿蒙运行配置中设置 DevEco Studio 的安装路径

image.png

3.鸿蒙开发证书生成和配置

证书资料文件

需要设置的文件总共有三个：

  • 私钥库文件（.p12）：里面保存着数字签名用的私钥，由开发者自己手动生成或者 DevEco Studio 自动申请调试证书时自动生成。有两层密码保护（私钥库密码和私钥密码），须妥善保管，尤其是发布证书的私钥一定不能泄露。
  • 证书文件（.cer）：由华为签署颁发，用于证明开发者的身份。在 AppGallery Connect 手动申请并下载获得，或者在自动生成调试证书时自动下载。
  • 签名描述文件（.p7b）：由华为颁发，里面包含了跟应用相关的签名信息，如包名、ACL 权限等，调试证书还包括可用于调试运行的设备列表。在 AppGallery Connect 手动添加并下载获得，或者在自动生成调试证书时自动下载。

image.png

话不多说，直接开始生成步骤：

1.第一步在 DevEco Studio 找到 Build 倒数第二个 Generate Key and CSR ，中文如下图所示:

1.png

2.点击后弹出这个生成密钥的小窗口如图所示：

2.png

3.点击新增证书New按钮后会弹出小窗口，设置生成的文件名和存放位置和密码，密码要记住，可以用txt文本记住哦

密码规则：密码必须包含至少8个字符，并且必须包含以下任意两种字符中的任意一种： 密码必须包含至少8个字符，并且必须包含以下任意两种字符中的任意一种：

  • 1.小写字母：a-z
  • 2.大写字母：A-Z
  • 3.数字：0-9
  • 4.特殊字符："-!@#$%6^&"0-_=+0;";"<>?

3.png

4.png

4.设置Alias别名，完成后点击下一步

5.png

5.上面就设置好了p12证书的地址和名称，下面设置好csr证书的文件存放地址和名称(可以都放在同一个文件夹下并名字相同，方便使用)如图：

6.png

6.设置好csr证书的文件存放地址和名称后，点击完成，可以在文件夹查看是否生成文件，至此p12文件和csr文件已经生成好了，如下图所示：

7.png

8.png

7.打开AppGallery Connect平台，需要登陆华为账号。登录成功后，点击 证书、APP ID和Proflie

image.png

8.点击新增证书

9.png

9.设置证书名称和证书类型，这里需要用到上面生成的csr文件

10.png

11.png

12.png

10.然后点击提交后并下载刚生成的 cer证书

13.png

11.点击开发与服务，选择自己的项目，没有项目的可以先添加项目，如图所示：

14.png

12.创建新项目（已有项目的可跳过）

image.png

13.点击添加应用，选择鸿蒙OS，点击创建APP ID

image.png

image.png

14.填写应用名称和应用包名，HbuilderX运行的时候需要用到哦

image.png

15.先添加自己的设备，用 DevEco Studio模拟器的同学们，如果不知道UDID，可以直接在HbuliderX运行到鸿蒙模拟器，点击查看调试证书，即可看到模拟器UDID

16-1.png

16.添加好设备后，来创建Profile，点击添加

15.png

16.，Profile名称自己命名，类型选择调试，选择设备 里面全选，申请权限选择受限权限(根据个人需要)然后选择右上角添加

16.png

17.png

17.生成Profile后，点击下载保存到刚才其他证书的文件里，可查看文件夹 p7b文件

18.png

18.现在证书都已经生成好了，然后再去把对应项目关联一下证书，点击 开发与服务，选择对应的项目

19.png

19.然后找到SHA256证书/公钥指纹:点击添加添加公钥指纹 (HarmonyOS API 9及以上)，添加刚才创建的证书即可

20.png

21.png

20.最后就是使用HbuilderX运行了，点击运行到鸿蒙，点击配置调试证书
  • 输入前面生成项目的包名
  • 点击自动申请调试证书，即可一键写入

22.png

21.嘿嘿，可看到已成功运行到DevEco Studio模拟器

image.png

23.png

本文纯属记录，也希望能够给第一次用uniappX开发鸿蒙的小伙伴们一点点方向，有问题地方望大佬指正（认真学习脸）

image.png

下次再见！🌈

Snipaste_2025-04-27_15-18-02.png

avatar
文章
阅读
粉丝