一、环境准备

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注册完全一致 }
2. 签名失效场景证书过期（有效期1年）设备类型变更（e.g. 手机→手表需新证书）
3. 隐私合规动态权限申请需在应用内实现隐私政策链接必须可访问

最佳实践：测试阶段使用 Debug 证书，上架前切换 Release 证书多设备支持需在 build-profile.json5 声明目标设备类型："targets": [{ "name": "default", "deviceTypes": ["phone", "tablet", "tv"] }]