2025年10月鸿蒙App手动签名、打包详细全流程

以下流程截止2025年10月，不保证以后流程完全按照下面的步骤进行，注意核实。

鸿蒙App在打包前，要进行签名。错误的App签名，在上传App到HUAWEI AppGallery Connect的时候会检测不通过。

我遇到了下面两个问题：

1、鸿蒙App合法检测结果：错误码：993，表示：Profile文件非法。

这个应该是没有手动签名，或者使用其他包的Profile文件，或者是原Profile删除了，重新申请一个就行，我下面有流程说明。

2、要上传的鸿蒙App的包名，一定要和备案的包名相同，否则在备案信息一项中的“校验证件号码”会不通过，这里虽然备注说不通过不影响后面的审核，但原则上应该要和备案的包一样。

我就是重新起了一个包名，看到这里，删除应用重新申请了。

以下是手动签名打包全流程：

一、生成私钥和证书请求文件

在顶部菜单栏中，依次打开“构建”->“生成私钥和证书请求文件”

二、创建 .p12 格式文件

在打开的弹窗中，点击“new”，创建 .p12 文件。

在弹窗的 Key store file中，点击文件夹图标，在指定位置输入 .p12文件名，再点击确认。

确认后，再输入密码，需要确认一次。

三、生成CSR文件

上面步骤完成后，如下图：

输入Alias，这个需要记住。再点击 Next。

在下面的对话框中，输入要生成的 .csr 文件名，最后点击完成Finish。

通过以上步骤后，会有如下两个文件生成出来：

linyufanjizhang.csr

linyufanjizhang.p12

四、申请证书

打开HUAWEI AppGallery Connect官网，打开首页的“证书、App ID和Profile”菜单。

在证书一栏点击“新增证书”，选择刚才生成的 .csr 文件。

证书名称随便写一个，证书类型选择“发布证书”，或者“测试证书”。

生成后，下载这个文件，格式是 .cer 的文件。

五、申请Profile文件

点击左侧的Profile菜单，所有信息填写完成后，点击“添加”。

完成后，下载 .p7b 格式文件。

到这里我们就有了4种格式的文件，分别是：

linyufanjizhang.csr

linyufanjizhang.p12

linyufanjizhang.p7b

linyufanjizhang.cer

六、配置项目签名信息

在菜单中打开“项目结构”，分别填入刚才的信息和文件地址，如下图：

我建议新添加一个签名信息，不要使用Defaule，默认的这个用自动生成的签名进行调试用。最后点击申请Appley。

七、打包App

我这里选择的是手动打包鸿蒙App，没有使用自动打包。

1、配置 build-profile.json5文件

打开项目级下面的build-profile.json5文件，找到signingConfig配置，如下图：

设置不同的签名。

2、设置Build Mode

打开如上图的Build Mode 设置对话框，将默认的Debug设置为Release，点击申请Apply，编辑器会自动重新编辑工程。

3、打包鸿蒙App文件

在顶部菜单栏中，依次点击“构建”->“编译Hap(s)APP(s)”->“编译APP(s)”，如下图：

等待编译完成后，会生成如如下的文件，点击上传到HUAWEI AppGallery Connect就可以了。

上传带签名的文件。

八、系统初步验证App包

上传的App包如果合法性没有问题，就会自动进入“上架自检”流程。如下图：

如果检测没有问题，就可以进行提交了。

注意：旧版本的App这里，没有上架自检，需要自己在开发工具中完成初点自检。