引言应用上架是开发周期的最后一公里。代码写得再好如果无法顺利通过华为应用市场AppGallery的审核并触达用户一切努力都大打折扣。HarmonyOS 应用的上架流程涉及 AGConnect 平台配置、签名证书管理、构建打包、应用市场提交、审核规范等多个环节每个环节都有明确的规则和常见的踩坑点。本文基于「节气通」的真实上架经验提供一份从零到通过审核的完整指南。学习目标完成本文后你将能够✅ 完成华为开发者账号注册与 AGConnect 项目创建✅ 配置应用签名证书调试/发布✅ 执行正式包的构建与打包✅ 在 AppGallery 提交应用并填写合规信息✅ 理解审核规则避免常见驳回原因✅ 掌握版本更新与灰度发布流程上架全流程概览┌─────────────────────────────────────────────────────┐ │ 应用上架完整流程 │ │ │ │ 1. 准备阶段 │ │ ├─ 注册华为开发者账号 │ │ ├─ 创建 AGConnect 项目 │ │ └─ 配置应用基本信息 │ │ │ │ 2. 签名配置 │ │ ├─ 申请发布证书 (.p12 / .cer) │ │ ├─ 配置 Profile 签名描述文件 │ │ └─ DevEco Studio 中关联签名 │ │ │ │ 3. 构建打包 │ │ ├─ 构建 Release 包 (.app) │ │ └─ 验证包体信息 │ │ │ │ 4. 提交上架 │ │ ├─ AppGallery Connect 创建应用 │ │ ├─ 填写应用信息名称/分类/截图/描述 │ │ ├─ 上传安装包 │ │ ├─ 填写隐私协议、内容分级、权限说明 │ │ └─ 提交审核 │ │ │ │ 5. 审核与发布 │ │ ├─ 人工/自动审核 │ │ ├─ 处理审核意见如被驳回 │ │ ├─ 审核通过 → 正式发布 / 分阶段发布 │ │ └─ 版本更新迭代 │ │ │ └─────────────────────────────────────────────────────┘步骤1: 准备工作1.1 注册华为开发者账号入口: https://developer.huawei.com/项目说明账号类型华为账号手机号或邮箱注册认证要求个人开发者实名认证企业开发者企业认证费用注册免费但部分服务如高级分析需付费注意事项一个账号可创建最多 100 个应用1.2 创建 AGConnect 项目AGConnectAppGallery Connect是华为应用服务的统一管理后台。操作路径: 登录 developer.huawei.com → 控制台 → 我的项目 → 添加项目 → 填写项目名称如: JieQiTong → 选择平台: Web / Android / HarmonyOS (选 HarmonyOS) → 创建项目1.3 在项目中添加应用操作路径: 项目列表 → 点击刚创建的项目 → 添加应用 → 应用名称: 节气通 → 应用包名: com.example.jieqitong (必须与代码中 module.json5 的 bundleName 一致!) → 应用类别: 工具 / 生活(根据实际选择) → 默认语言: 中文 → 创建应用关键:bundleName必须与代码完全一致否则签名校验不通过。创建成功后记录以下信息信息位置用途APP ID应用信息 → AppGallery Connect 配置应用唯一标识Client ID应用信息 → OAuth 2.0 客户端ID第三方认证API Key项目设置 → 常规HMS SDK 初始化步骤2: 签名配置HarmonyOS 应用必须经过数字签名才能在真机上运行和上架。2.1 签名类型对比类型文件格式用途有效期调试签名自动生成DevEco Studio开发调试临时发布签名.p12 .cer正式上架1年 / 3年 / 更长2.2 申请发布证书方式一通过 AGConnect 生成推荐操作路径: AppGallery Connect → 用户与访问 → 证书管理 → 添加证书 → 类型: 发布证书 → 证书文件: 上传 CSR 文件见下方生成方法 → 别名: JieQiTong_Release → 有效期: 选择建议 3 年以上 → 确认生成本地 CSR 文件# 使用 keytool 生成证书请求文件keytool-genkeypair\-aliasjieqitong_release\-keyalgRSA\-keysize2048\-validity3650\-keystorejieqitong.keystore# 从 keystore 导出 CSRkeytool-certreq\-aliasjieqitong_release\-filejieqitong.csr\-keystorejieqitong.keystore提示: CSR 生成过程中会要求输入姓名、组织等信息。个人开发者填真实姓名即可。下载证书文件CSR 审核通过后下载获得.cer文件 — 数字证书将.cer导入本地 keystore# 导入华为签发的证书到 keystorekeytool-importcert\-filehuawei_release.cer\-aliashuawei_release_cert\-keystorejieqitong.keystore2.3 配置 Profile 签名描述文件Profile 文件定义了哪些设备可以安装该应用。操作路径: AppGallery Connect → 用户与访问 → 管理签名公钥指纹 → 添加公钥指纹从你的 keystore 获取 # 获取 SHA-256 指纹 keytool -list -v -keystore jieqitong.keystore -alias jieqitong_release然后创建 ProfileAppGallery Connect → 我的项目的对应应用 → 添加 Profile → 类型: 发布 → 证书: 选择上面创建的发布证书 → 设备类型: Phone / Tablet按需要选择 → 有效期: 与证书一致 → 下载 .profile 文件2.4 DevEco Studio 中配置签名// build-profile.json5 中配置签名信息 { app: { signingConfigs: [ { name: default, type: HarmonyOS, material: { storePassword: 你的keystore密码, certpath: ./signing/huawei_release.cer, keyAlias: jieqitong_release, keyPassword: 你的key密码, profile: ./signing/JieQiTong_Release.p7b, signAlg: SHA256withECDSA, storeFile: ./signing/jieqitong.keystore } } ], products: [ { name: default, signingConfig: default, // ← 使用上面的签名配置 compatibleSdkVersion: 5.0.0(12), runtimeOS: HarmonyOS } ] } }或者通过 IDE 图形界面配置File → Project Structure → Signing Configs ☑ Enable HarmoniousApp Signing → 选择 Sign In 登录华为账号自动同步证书 或 → Use local certificate → Store File: 选择 .keystore 文件 → Key Alias: 输入别名 → Passwords: 输入 keystore 和 key 密码 → Certpath: 选择 .cer 文件 - Profile: 选择 .p7b 文件安全提醒:build-profile.json5中的密码明文存储不要提交到 Git 仓库建议使用环境变量或在 CI 流水线中注入。步骤3: 构建打包3.1 构建前检查清单检查项要求检查方式bundleName与 AGConnect 一致module.json5versionCode递增每次发版1app.json5versionName语义化版本号如 1.0.0app.json5minAPIVersion不高于目标系统版本build-profile.json5签名配置正确发布证书非调试Signing Configs无调试代码移除 console.log / debugger全局搜索资源文件完整图片/字体/字符串齐全编译无报错3.2 执行构建# 方式一DevEco Studio 菜单Build → Build Hap(s)/APP(s)→ Build APP(s)# 方式二命令行hvigorw assembleHapp--modemodule-pproductdefault-pbuildModerelease构建产物位置entry/build/default/outputs/default/ └── entry-default-signed.app # 这就是最终的上架包3.3 验证包体信息# 查看包体基本信息确认签名正确# 在 DevEco Studio 中:Build → Analyze HAP/APK → 选择生成的 .app 文件# 确认项:# ✓ 包名 (Package Name): com.example.jieqitong# ✓ 版本号 (Version): 1.0.0 (code: 1)# ✓ 签名证书信息: 显示你的发布证书# ✓ 权限列表: 符合预期# ✓ 文件大小: 一定限制通常单包500MB步骤4: 提交到 AppGallery4.1 进入 AppGallery Connect 后台入口: https://appgallery.huawei.com/ → 使用开发者账号登录 → 选择我的应用 → 创建应用如果在 AGConnect 已创建则直接看到4.2 填写应用基础信息字段要求示例应用名称简洁有辨识度不含官方第一等违规词节气通应用简介200字以内清晰描述功能了解二十四节气的时间、习俗与文化详细描述支持 Markdown详细说明功能和特色见下方模板应用图标512×512 PNG无圆角无水印准备好设计稿应用截图至少 3 张推荐 5 张手机实机截图分类主分类 子分类工具 日历/时间关键词最多 5 个用逗号分隔节气,二十四节气,农历,日历,传统文化语言支持的语言中文简体, English详细描述模板参考【产品介绍】 节气通是一款专注于中国传统文化——二十四节气的知识类应用。 涵盖24个节气的详细信息包括时间、气候特征、农事活动、民俗文化、养生建议等内容。 【核心功能】 • 二十四节气百科每个节气的起源、三候、习俗、诗词 • 农历日历查询公历农历对照节日提醒 • 节气倒计时下一个节气的精确时间 • 传统文化知识节气相关的历史故事和文化内涵 • 多语言支持中文 / English • 暗色模式护眼主题夜间阅读更舒适 【适用场景】 • 学习传统文化 • 农事活动参考 • 养生保健指导 • 教育科普工具 【更新说明】 V1.0.0 - 首次发布包含完整的二十四节气内容库 - 支持多语言切换 - 支持暗色模式4.3 应用截图规范规格要求尺寸手机截图最小 1080px 宽平板 2048px格式JPG 或 PNG数量3~10 张内容不能含模拟器/调试信息/其他App水印状态栏可以保留但不能显示异常信息截图技巧:// 截图前建议做的准备// 1. 使用真机截图不要用模拟器// 2. 时间设为美观的时间如 10:08// 3. 电量/信号正常显示// 4. 清空通知栏// 5. 准备好各页面的截图首页、详情页、百科页、设置页4.4 隐私协议这是审核必查项必须认真填写。AppGallery Connect → 应用 → 内容 → 隐私协议 → 上传 PDF 或填写在线协议隐私协议必须包含的内容必须项说明收集的信息明确列出收集了哪些数据设备信息/日志/用户输入等收集目的每种数据的用途数据共享是否向第三方共享共享给谁用户权利查看/导出/删除数据的方式联系方式开发者邮箱或客服渠道协议更新方式如何通知用户新版协议生效日期协议生效时间模板要点节气通用《节气通隐私政策》 生效日期: 2026年6月 一、我们收集哪些信息 1. 设备信息设备型号、操作系统版本用于适配 2. 日志信息崩溃日志、性能数据用于改进体验 3. 用户内容您主动输入的反馈信息 二、我们如何使用信息 • 提供和改进我们的服务 • 分析应用使用情况以优化功能 三、信息的存储 • 数据存储于您的设备本地 • 匿名统计数据加密传输至服务器 四、您的权利 • 您可以在设置中关闭数据统计 • 您可以导出您的本地数据 • 您可以卸载应用以删除所有数据 五、联系我们 • 邮箱: supportexample.com4.5 内容分级AppGallery Connect → 应用 → 内容 → 内容分级 → 根据问卷回答自动评级对于节气通这类应用通常评级为3Parental Guidance或PGParental Guidance Suggested问题推荐 answer是否包含暴力内容否是否包含色情内容否是否包含赌博元素否是否包含药品相关否养生建议不属于是否需要联网是可选用于内容更新是否包含第三方广告视实际情况4.6 权限使用说明AppGallery Connect → 应用 → 内容 → 隐私 → 权限 → 逐个声明每个权限的使用场景权限使用场景是否必需ohos.permission.INTERNET加载远程内容、数据更新是可选ohos.permission.NOTIFICATION_CONTROLLER发送节气提醒通知是可选ohos.permission.READ_MEDIA读取用户选择的图片否当前未使用重要: 只声明实际使用的权限多余的权限申请会导致审核质疑。4.7 提交审核所有信息填写完成后1. 点击保存保存草稿 2. 全面检查一遍所有字段 3. 点击提交审核 4. 等待审核结果通常 1-3 个工作日步骤5: 审核与常见驳回原因5.1 审核流程提交审核 │ ▼ ┌─────────────┐ │ 自动检测 │ ← 包体扫描、病毒检测、权限检查 │ (~30分钟) │ └──────┬──────┘ │ 通过 ▼ ┌─────────────┐ │ 人工审核 │ ← 内容审查、截图验证、协议检查 │ (1-3天) │ └──────┬──────┘ │ ├── 通过 → 可选择发布策略 │ ├── 立即全量发布 │ └── 分阶段发布灰度 │ └── 驳回 → 修改后重新提交5.2 常见驳回原因及解决方案Top 1: 隐私协议不规范驳回理由: 隐私协议缺少数据共享说明 / 未说明用户权利 解决: - 对照上文隐私协议必须包含的内容逐项检查 - 特别是数据共享和用户权利两个章节最容易遗漏Top 2: 应用名称违规驳回理由: 应用名称包含官方最第一等绝对化词汇 或名称与实际功能不符 解决: - 名称只做功能性描述节气通二十四节气助手 - 避免:中国第一节气APP官方节气大全Top 3: 截图不符合规范驳回理由: 截图含有模拟器标识 / 分辨率不足 / 含其他App水印 解决: - 务必使用真机截图 - 最小宽度 1080px - 不要用带水印的截图工具Top 4: 权限过度申请驳回理由: 申请了不必要的权限如读取联系人/定位等 解决: - module.json5 中删除不需要的权限 - 在 AppGallery 中补充每个权限的使用场景说明 - 如果确实不需要某权限直接移除重新打包Top 5: 应用功能不完整驳回理由: 存在无法使用的空白页面 / 功能报错 解决: - 所有页面都要有实际内容 - 空状态要有友好提示 - 网络请求失败时不能白屏 - 测试所有入口后再提交Top 6: 缺少退出机制驳回理由: 应用没有明确的退出入口 解决: - 设置页添加退出登录/退出应用按钮 - 或确保系统能通过返回键退出5.3 快速过审技巧技巧说明参考同类已上架应用看看别人怎么写描述、怎么截图先提交一次试水第一次可能被驳回根据反馈改就好隐私协议越详细越好宁多勿少覆盖所有数据使用场景截图要精美第一印象很重要影响用户下载转化回复审意见要及时驳回后尽快修改重提通常二次审核更快步骤6: 发布策略6.1 发布选项策略说明适用场景立即发布审核通过后对所有用户可见小版本更新 / 紧急修复定时发布设定具体时间自动发布重要版本选择合适时机分阶段发布先推送给少量用户逐步扩大大版本更新 / 有风险的功能6.2 分阶段发布灰度AppGallery Connect → 应用分发 → 管理 → 发布策略 → 选择分阶段发布 → 第一阶段: 5% 用户观察 24h → 第二阶段: 20% 用户观察 48h → 第三阶段: 50% 用户观察 72h → 第四阶段: 100% 全量灰度期间关注指标崩溃率目标 0.2%用户反馈应用市场评论核心功能可用性性能指标启动速度、页面加载6.3 版本更新流程发现 Bug / 新需求 │ ▼ 修改代码 → bump versionCode 和 versionName │ ▼ 构建新包 (确保 signing config 正确) │ ▼ AppGallery Connect → 上传新版本包 │ ▼ 填写版本更新说明用户可见的更新内容 │ ▼ 提交审核 → 审核通过 → 发布版本号规范versionFormat: MAJOR.MINOR.PATCH MAJOR: 重大架构变更或不兼容更新 (1.0.0 → 2.0.0) MINOR: 新增功能 (1.0.0 → 1.1.0) PATCH: Bug修复 (1.0.0 → 1.0.1) versionCode: 单调递增整数 (每次提交必须 1) V1.0.0 → code: 1 V1.0.1 → code: 2 V1.1.0 → code: 3 V2.0.0 → code: 4步骤7: 上架后的运营7.1 应用市场优化 (ASO)优化项操作影响关键词选择精准搜索词节气/农历/日历/传统文化搜索排名应用图标简洁、辨识度高、在小尺寸下也清晰点击率 (CTR)截图展示核心功能亮点首图最重要转化率应用描述前3行最重要搜索结果显示时截断安装意愿评分与回复及时回应用户评价处理差评排名权重类别选择放在竞争较小但精准的分类曝光量7.2 数据监控AppGallery Connect → 分析 → 应用分析 • 新增用户 / 活跃用户 / 留存率 • 下载量 / 安装量 / 卸载量 • 来源分析搜索/推荐/分享 • 评分趋势 → 性能分析 • 崩溃报告必看 • 启动时长 • 页面加载时间 • ANR 率上架检查清单终极版提交审核前逐项确认代码层面bundleName与 AGConnect 一致versionCode递增versionName合理无调试代码debugger / 过多的 hilog签名为发布证书非调试签名所有页面功能正常无空白页/崩溃有明确的退出机制网络超时有友好提示应用信息层面应用名称不含违规词官方/最/第一图标 512×512 PNG无圆角无水印截图 ≥3 张1080px真机截图描述清晰前3行有吸引力分类准确合规层面隐私协议完整6项必备内容都有内容分级已填写每个权限都有使用场景说明无多余权限申请第三方 SDK 有隐私说明如有打包产物包体格式为.appHAP/APP包体大小合理通常 50MB签名信息验证通过安装到真机能正常运行相关链接项目源码: GitCode仓库应用下载: 华为应用市场华为开发者联盟: 华为开发者联盟AppGallery Connect: AppGallery Connect