鸿蒙应用开发实战【85】— 应用签名与正式HAP打包

鸿蒙应用开发实战【85】--- 应用签名与正式HAP打包

本文是「号码助手全栈开发系列」第 85 篇,持续更新中...

开源社区:https://openharmonycrossplatform.csdn.net


前言

开发完成的应用需要通过签名才能安装到真机或上架应用市场。HarmonyOS 应用使用华为的签名体系(HAP 包签名),涉及证书文件(.cer/.p7b)、Profile 文件和密钥库(.p12)。本篇以号码助手项目为例,梳理从签名到正式包的全流程。

本篇涵盖:签名文件类型(p12/cer/p7b)、AGC 上申请证书和 Profile、DevEco Studio 自动签名配置、release 构建模式配置、HAP 包产物验证、命令行签名工具。


一、签名文件体系

HarmonyOS 应用签名需要三个文件:

文件 扩展名 作用 来源 安全等级
密钥库 .p12 私钥 + 公钥证书链 DevEco Studio 生成或 AGC 下载 🔴 绝不泄露
证书文件 .cer 应用签名证书 AGC → 证书管理 🟢 可公开
Profile .p7b 权限配置 + 设备白名单 AGC → 证书管理 🟢 可公开

二、DevEco Studio 自动签名

复制代码
1. 打开项目 → Build → Generate Key & CSR
2. 填写密钥信息(别名、密码)→ 生成 .p12
3. 到 AGC 上传 CSR → 下载 .cer 证书
4. AGC 创建 Profile(关联证书)→ 下载 .p7b
5. DevEco Studio → Project Structure → Signing Configs
   ├── Store File: xxx.p12
   ├── Store Password: ****
   ├── Key Alias: myapp
   ├── Key Password: ****
   ├── Cert Path: xxx.cer
   └── Profile: xxx.p7b
6. Build → Build HAP(s) → 选择 release

三、工程签名配置

3.1 build-profile.json5

json5 复制代码
{
  "app": {
    "signingConfigs": [
      {
        "name": "myconfig",
        "storeFile": "/path/to/keystore.p12",
        "storePassword": "****",
        "keyAlias": "myapp",
        "keyPassword": "****",
        "signAlg": "SHA256withECDSA",
        "profileFile": "/path/to/profile.p7b",
        "certPath": "/path/to/cert.cer"
      }
    ],
    "products": [
      {
        "name": "default",
        "signingConfig": "myconfig",
        "buildModeSet": ["debug", "release"]
      }
    ]
  }
}

3.2 双模式构建

json5 复制代码
"buildModeSet": [
  { "name": "debug" },    // 调试包:可调试、含日志
  { "name": "release" }   // 正式包:优化、无调试信息
]

四、命令行打包

bash 复制代码
# Debug 包
hvigorw assembleHap --mode module -p module=entry -p buildMode=debug

# Release 包
hvigorw assembleHap --mode module -p module=entry -p buildMode=release

# 产物位置
entry/build/default/outputs/default/
├── entry-debug-1.0.0.hap
└── entry-release-1.0.0.hap

五、验证 HAP 包

bash 复制代码
# 解压 HAP(实为 ZIP)
unzip entry-release-1.0.0.hap -d hap_extracted

# 查看签名信息
# 使用 DevEco Studio 的 Verify HAP 工具
# Build → Verify HAP

小结

要点 说明
签名三件套 .p12(密钥库)+ .cer(证书)+ .p7b(Profile)
AGC 流程 创建应用 → 申请证书 → 生成 Profile
自动签名 DevEco Studio Project Structure 配置
构建模式 debug(调试)vs release(正式)
命令行 hvigorw assembleHap -p buildMode=release
产物检查 HAP 包大小、签名校验

如果这篇文章对你有帮助,欢迎点赞👍、收藏⭐、关注🔔,你的支持是我持续创作的动力!


相关资源:

相关推荐
GitCode官方17 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追19 小时前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追1 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos
jianqiang.xue1 天前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
程序猿追1 天前
鸿蒙 PC 用 Tauri 迁移配置文件,先保留旧版再写新版
华为·harmonyos
码间留白2 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农2 天前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos
我闪了个去2 天前
一个 Scroll 撑起整个首页:HarmonyOS 7 懒加载布局把网格、瀑布流、吸顶分组装进一次滚动
harmonyos·arkts