HarmonyOS 鸿蒙NEXT打包流程

一、环境准备

1. 开发环境配置

   • 安装 DevEco Studio（官方 IDE）
   • 配置 HarmonyOS SDK（API Level ≥ 目标版本）

2. 上架资质申请

   • 华为开发者账号实名认证
   • 在 AppGallery Connect（AGC）提交应用资质审核

二、AGC 项目创建

三、应用/元服务创建

A[添加应用] --> B{选择类型} B -->|标准应用| C[APP (HarmonyOS)] B -->|轻量化服务| D[元服务] C --> E[填写包名 = bundleName] D --> E

核心要求：

• 包名一致性：bundleName 必须与项目 module.json5 完全匹配
• 元服务标识：轻量化场景需勾选"是否元服务"

四、编译打包（DevEco Studio）

1. 证书管理

2. 签名配置

// build-profile.json5
"signingConfigs": [
  {
    "name": "release",
    "material": {
      "certpath": "cert.cer",    // 发布证书
      "storePassword": "******", // 密钥库密码
      "keyAlias": "releaseKey",  // 密钥别名
      "keyPassword": "******",   // 密钥密码
      "storeFile": "key.p12"     // 密钥库文件
    }
  }
]

3. 构建命令

• 标准应用：Build > Build Hap(s)/APP(s) > Build APP(s)
• 输出产物：
  • 手机：entry-unsigned.hap → 签名后为 entry-signed.hap
  • 智能设备：entry-unsigned.app → 签名后为 entry-signed.app

五、上架审核（AGC）

1. 填写元数据

2. 上传产物

• 拖拽签名后的 HAP/APP 文件至"软件包"区域
• 自动检测 API 兼容性及安全规范

3. 提交审核

• 完成信息填写 → 点击提交审核
• 审核周期：通常 1-3 个工作日

避坑指南

1. 包名校验

// module.json5
"module": {
  "name": "entry",
  "type": "entry",
  "bundleName": "com.company.app", // 必须与AGC注册完全一致
}

1. 签名失效场景

   • 证书过期（有效期1年）
   • 设备类型变更（e.g. 手机→手表需新证书）

2. 隐私合规

   • 动态权限申请需在应用内实现
   • 隐私政策链接必须可访问

最佳实践：

• 测试阶段使用 Debug 证书，上架前切换 Release 证书
• 多设备支持需在 build-profile.json5 声明目标设备类型：

"targets": [
  {
    "name": "default",
    "deviceTypes": ["phone", "tablet", "tv"]
  }
]