当前位置：首页 > ops >正文

HarmonyOS应用上架流程详解

ops 2025/7/27 18:24:51

HarmonyOS应用上架是确保应用触达用户的关键环节。本文基于华为官方文档，系统梳理了应用/元服务从开发完成到正式上架AppGallery Connect（AGC）的全流程，涵盖签名文件准备、编译构建、上传审核等核心步骤，帮助开发者高效完成应用发布。

签名文件生成与配置
- 生成密钥与证书请求文件 使用DevEco Studio生成密钥（.p12）和证书请求文件（.csr），用于申请发布证书。
- 申请发布证书与Profile文件
  
  在AGC中创建HarmonyOS应用/元服务，申请发布证书（
```
.cer
```
  ）和Profile文件（
```
.p7b
```
  ）。
  - 元服务特别注意：创建时需勾选“是否元服务”，包名格式为com.atomicservice.[appid]。
- 配置签名信息 在DevEco Studio的Project Structure > Signing Configs中配置签名参数（Store File、密码、Profile等）。
公钥指纹更新（条件必选） 若应用使用Account Kit、支付服务等开放能力，需在AGC更新公钥指纹（操作路径：应用签名证书指纹配置）。

构建Release类型包
- 在DevEco Studio中点击
  
  Build > Build Hap(s)/APP(s) > Build APP(s)
  
  ，默认生成Release类型包（路径：
```
build/outputs/default/MyApplication-default-signed.app
```
  ）。
- 注意事项
  
  ：
  - 删除工程中无需打包的HAP/HSP模块，避免冗余。
  - 确保所有HAP/HSP的bundleName、versionCode等配置一致。
合法性校验规则
- 多HAP场景要求Entry类型模块唯一，Feature类型模块可多个。
- 所有HAP/HSP的minCompatibleVersionCode、targetAPIVersion需保持一致。

登录与上传
- 在DevEco Studio中点击
  
  Build > Upload Product
  
  ，登录华为开发者账号。
- 选择上传类型：
  - 测试发布
    
    ：
```
Generate app package and upload to AGC for test
```
  - 正式发布：Generate app package and upload to AGC for test and publish
- 勾选Upload your app's symbols（符号表信息）。
填写应用信息
- 确认bundleName、版本号与AGC注册信息一致。
- 选择支持设备（手机、平板等），元服务需在module.json5中配置deviceTypes匹配AGC设置。
云测试与提交
- 上传后触发云测试，点击 Full results on AppGallery Connect 查看结果。
- 通过后提交上架申请，进入审核队列。

填写应用信息
- 在AGC控制台完善应用描述、截图、分类标签（如游戏需符合《游戏审核FAQ》）。
- 元服务特别注意：需完成隐私协议配置和备案（路径：应用信息 > 隐私政策）。
自检Checklist
- 合规性：内容符合《应用审核指南》，无病毒、诱导行为。
- 权限配置
  
  ：
  - 声明受限权限需提供场景说明（如
```
ohos.permission.MANAGE_SCREEN_TIME_GUARD
```
    ）。
  - 元服务需在module.json5的metadata中配置client_id和app_id。
- 功能验证
  
  ：
  - 华为账号登录需调用unionLogin接口。
  - 支付类应用必须接入IAP Kit。
端到端验证（适配场景）
- 设备从HarmonyOS升级到HarmonyOS NEXT后，验证数据迁移是否成功（通过OTA升级回退测试）。

上传失败：“软件包与声明支持设备不一致”
- 检查module.json5的deviceTypes是否与AGC所选设备一致（如手机需配置"phone"）。
签名错误：“Invalid AppId in bundle name”
- 元服务需确保
```
bundleName
```
  与AGC注册包名完全匹配（格式：
```
com.atomicservice.XXX
```
  ）。
审核驳回
- 权限不合规：受限权限需补充场景说明视频。
- 功能缺失：如游戏未调用init接口或缺少退出功能。