鸿蒙应用开发实战【97】— 应用发布AGC上架全流程本文是「号码助手全栈开发系列」第 97 篇持续更新中…开源社区https://openharmonycrossplatform.csdn.net前言当应用开发完成、测试通过后下一步就是在 AppGallery ConnectAGC上架。本篇覆盖从应用签名到应用商店发布的完整上架流程包括证书申请、打包、创建应用、提交审核等环节。本篇涵盖AGC 控制台应用创建、app.json5 配置解读、release HAP 打包、签名证书三件套、版本号管理、上架检查清单、发布渠道选择。一、App Scope 配置文件AppScope/app.json5{ app: { bundleName: com.fiona.numberassistant, vendor: fiona, versionCode: 1000000, versionName: 1.0.0, icon: $media:app_icon, label: $string:app_name, distributedNotificationEnabled: false } }字段含义字段值说明bundleNamecom.fiona.numberassistant应用唯一标识与 AGC 创建的应用一致vendorfiona开发者名称versionCode1000000版本号整数新版本必须递增versionName1.0.0版本名称对用户展示icon$media:app_icon应用图标引用label$string:app_name应用名称引用二、签名证书三件套上架必须使用release 签名。需要先注册华为开发者账号并生成签名证书。2.1 文件类型文件后缀用途安全等级获取方式密钥库文件.p12包含私钥和公钥 绝不泄露DevEco Studio 生成证书文件.cer华为颁发的开发者证书 可公开AGC 证书管理Profile 文件.p7b包含包名和权限列表 可公开AGC 证书管理2.2 申请流程1. 登录 AGC → 用户与访问 → 证书管理 2. 生成 .p12 密钥库文件设置密码和别名 3. 上传 .p12 申请 .cer 开发者证书 4. 创建 .p7b Profile 文件关联证书 指定包名 5. 下载三件套到本地2.3 build-profile.json5 配置{ app: { signingConfigs: [ { name: release-sign, material: { certPath: ./signing/release.cer, profilePath: ./signing/release.p7b, keystorePath: ./signing/release.p12, keystorePassword: your-keystore-pwd, keyAlias: key1, keyPassword: your-key-pwd } } ], products: [ { name: default, signingConfig: release-sign } ] } }三、Release HAP 打包# 1. 清理./hvigorw clean# 2. Release 构建使用上面配置的签名./hvigorw assembleHap--modemodule-pmoduleentry-pbuildModerelease# 3. 生成 App Pack适用于 AGC 上架./hvigorw assembleApp--modemodule-pmoduleentry-pbuildModerelease# 4. 产物位置lsbuild/default/outputs/default/# entry-release.hap# entry-release.app ← 上架用这个产物说明文件用途entry-release.hap调试/自用安装entry-release.app上架 AppGallery包含 .hap 和签名信息四、AGC 上架流程4.1 创建应用1. 登录 AppGallery Connect https://developer.huawei.com/consumer/cn/service/agc 2. 我的应用 → 新建应用 3. 填写 └── 包名com.fiona.numberassistant与 app.json5 一致 └── 应用名称号码助手 └── 应用分类工具 → 实用工具 └── 语言中文(简体)4.2 上传包1. 发布 → 软件版本 → 创建新版本 2. 上传 entry-release.app 3. 系统自动解析包信息版本名、版本号、权限列表 4. 填写版本更新说明新功能列表 / Bug 修复4.3 填写应用信息信息项要求号码助手填写参考应用图标1024×1024 PNGAppScope/resources/base/media/app_icon.png应用截图至少 3 张首页/卡号管理/扫描页的截图应用简介80 字以内“一站式管理多卡号应用绑定…”应用描述2000 字以内详细介绍功能和使用场景隐私政策URL 或文本需要隐私政策页面版权信息IP 声明如有4.4 提交审核1. 检查清单确认无误 2. 提交审核 3. 审核周期约 1-3 个工作日 4. 审核通过 → 应用上架 5. 审核拒绝 → 查看拒绝原因 → 修改后重新提交五、版本号管理策略# 版本号递增脚本示例如下# versionCode 的格式主版本(2位) 次版本(2位) 补丁(2位)# 1.0.0 → 1000000# 1.1.0 → 1000100# 1.0.1 → 1000001# 2.0.0 → 2000000版本号规则versionName: 1.0.0 ← 对用户可见 versionCode: 1000000 ← 检测更新的依据必须递增六、上架检查清单检查项说明是否通过bundleName 唯一在 AGC 和应用中一致✅release 签名使用发布证书签名✅versionCode 递增比上一版本大✅权限最小化无多余权限声明✅隐私政策提供可访问的 URL✅应用截图至少 3 张覆盖核心功能✅测试通过ohosTest 全部通过✅性能优化Profiler 无内存泄漏✅小结阶段操作产物证书申请AGC 生成 .p12 → .cer → .p7b签名三件套配置app.json5 build-profile.json5 signingConfigsbundleName / versionCode打包hvigorw assembleApp -p buildModereleaseentry-release.app创建应用AGC 新建应用填入包名和分类AGC 应用条目提交上传 .app 填写信息 提交审核AGC 审核中发布审核通过后发布到 AppGallery正式上架如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源开源鸿蒙跨平台社区https://openharmonycrossplatform.csdn.netAppGallery Connecthttps://developer.huawei.com/consumer/cn/service/agcHarmonyOS 应用发布指南https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/publish-appHarmonyOS hilog文档https://developer.huawei.com/consumer/cn/doc/harmonyos-references/hilogHarmonyOS testinghttps://developer.huawei.com/consumer/cn/doc/harmonyos-guides/unit-testHarmonyOS 安全与权限https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/permissions-overview