In-house应用仅支持编译HAP 怎么打包发布签名的hap包

欢迎到专业群（ uni-app鸿蒙化技术交流群 ） 咨询，群中有相关专业的管理员和群友。

好的，针对你“in-house 应用仅支持编译 hap，怎么打包发布签名的 hap 包”这个问题，结合 uni-app 鸿蒙开发的实际情况，这里为你梳理一下核心逻辑和操作步骤。

鸿蒙和 ios 类似，不支持随意侧载安装 .hap 包。官方渠道（应用市场）要求提交 .app 文件。对于企业内部或个人测试分发，需要走华为的内部测试或企业分发流程。

核心概念澄清

1. .app 与 .hap 的关系：在 hbuilderx 中，【发行】-【app-harmony-本地打包】产出的 .app 文件，本质上是一个压缩包。你可以把它当作 .zip 文件解压，里面就能找到签名后的 .hap 文件。
2. 直接安装 .hap 的限制：你不能直接将这个 .hap 文件发给别人，像安卓 .apk 那样安装。鸿蒙系统会校验签名和设备的 udid 是否在证书的授权范围内。

实现 in-house（企业内部分发）的步骤

整个流程可以概括为：申请证书 → 配置签名 → 打包 → 分发安装。

第一步：申请内部测试/发布证书

你需要去华为 appgallery connect 后台，为你的应用申请内部测试或发布证书。

• 调试证书：仅用于开发调试，有设备 udid 限制。
• 内部测试/发布证书：用于企业分发或上架。申请流程参考官方文档：申请发布证书。

关键点：在申请 profile 文件时，需要添加所有目标测试设备的 udid。这是设备能安装该 .hap 包的前提。

第二步：在 hbuilderx 中配置签名

1. 生成配置文件：首次在 hbuilderx 中点击【发行】-【app-harmony-本地打包】，项目根目录会自动生成 harmony-configs 文件夹。

2. 配置发布证书：打开 harmony-configs/build-profile.json5 文件，在 app.signingConfigs 数组里，添加一个 name 为 "release" 的配置项，填入你申请到的发布证书信息。注意区分调试证书（name: "default"）和发布证书（name: "release"），不能混用。

   // harmony-configs/build-profile.json5  
   {  
     "app": {  
       "signingConfigs": [  
         {  
           "name": "release", // 发布证书配置  
           "type": "HarmonyOS",  
           "material": {  
             "storeFile": "d:/鸿蒙发布证书/your.p12", // 密钥库文件路径  
             "storePassword": "******", // 密钥库密码  
             "keyAlias": "your_alias", // 密钥别名  
             "keyPassword": "******", // 密钥密码  
             "signAlg": "SHA256withECDSA",  
             "certpath": "d:/鸿蒙发布证书/your.cer", // 证书文件路径  
             "profile": "d:/鸿蒙发布证书/your.p7b" // profile 文件路径  
           }  
         }  
         // ... 其他配置  
       ],  
       "products": [  
         {  
           "name": "release",  
           "signingConfig": "release" // 指定使用 release 配置  
         }  
         // ... 其他配置  
       ]  
     }  
   }  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

第三步：打包生成 .app 文件

配置好签名后，再次点击 hbuilderx 的【发行】-【app-harmony-本地打包】。打包成功后，控制台会输出 .app 文件的路径。

第四步：从 .app 中提取 .hap 包

.app 文件本质上是一个压缩包。使用解压软件（如 7-zip）打开或解压它，你可以在类似 entry/build/default/outputs/default 的路径下找到 entry-default-signed.hap 文件。这个就是签名后的 hap 包。

第五步：分发与安装

你不能直接将 .hap 文件发给用户安装。需要走华为官方的内部测试分发流程：

1. 登录 appgallery connect 网站。
2. 进入你的项目，找到“版本测试”或类似的内测分发功能。
3. 上传你的 .app 包。华为会生成一个测试链接。
4. 将测试链接发给测试人员。他们通过链接打开并安装，系统会校验设备 udid 是否在证书的 profile 文件中。

这整个过程类似于 ios 的 testflight 测试。

补充说明

• 命令行安装（仅限调试）：在开发调试阶段，可以使用 hdc app install 命令安装 .hap 包，但这需要设备已授权且证书包含设备 udid，不适合大规模分发。
• uni-app 鸿蒙元服务：如果你开发的是鸿蒙元服务（mp-harmony），流程类似，但需要参考元服务的发布文档，配置 mp-harmony 下的签名。

参考链接

• 鸿蒙企业应用内部分发打包教程
• uni-app 鸿蒙运行和发行官方文档