HarmonyOS 6.1 上架实战：从“Demo”到“商品”的AGC全链路通关

系列终极实战篇·第50篇收官之作。性能调优篇后有独立开发者问“Demo在本地跑得完美了但怎么上架华为应用市场听说审核很严经常被拒有没有一份‘避坑指南’” 这正是最后一道关卡。今天我们将电商Demo打包、签名、提审走完AppGallery Connect (AGC)的全流程覆盖资质准备、隐私合规自检、上架材料撰写、审核沟通技巧、灰度发布策略。我们将复盘常见的“秒拒”原因并分享如何通过预审服务提高通过率。全程基于API23含官方文档未涉及的“审核员视角解读”和“商业化变现配置”技巧。一、前言为什么“开发完成”只是“万里长征第一步”很多开发者折戟在应用市场上架环节。常见的拒审理由包括隐私政策问题未提供隐私政策或隐私政策中未说明数据收集类型。权限滥用申请了与功能无关的权限如“读取通讯录”用于电商。功能性缺陷点击按钮无反应或存在明显Crash。内容违规包含虚假宣传、赌博、色情等内容。元数据缺失应用介绍、截图、图标不符合规范。核心认知应用市场审核不仅是技术检查更是合规性、安全性、用户体验的综合评估。今天我们将站在审核员的角度反向检查我们的电商Demo确保一次通过。二、核心概念辨析上架关键要素要素定义重要性常见错误应用包HAP​最终交付的安装包⭐⭐⭐⭐⭐未签名、包含调试信息、体积过大隐私政策​告知用户数据处理的文档⭐⭐⭐⭐⭐未提供URL、内容不全、未弹窗征求同意应用素材​图标、截图、视频⭐⭐⭐⭐截图包含其他品牌水印、视频模糊、图标有Alpha通道应用介绍​描述应用功能和特点⭐⭐⭐⭐夸大宣传、包含联系方式、关键词堆砌权限声明​解释为何需要某权限⭐⭐⭐⭐未说明用途、申请敏感权限无对应功能测试账号​供审核员登录的账号⭐⭐⭐未提供、密码错误、账号权限不足三、实战操作AGC上架全流程3.1 准备阶段资质与合规自检步骤1准备隐私政策使用AGC合规服务生成隐私政策URL参考第45篇。确保应用首次启动时弹窗征求用户同意。在应用内提供隐私政策的访问入口如“设置”-“隐私政策”。步骤2权限自查检查module.json5中的所有权限{ module: { requestPermissions: [ { name: ohos.permission.INTERNET, // 必需网络请求 reason: 用于加载商品数据、图片和支付功能, // 必须提供清晰理由 usedScene: { abilities: [EntryAbility], when: inuse // 仅在使用时申请 } }, { name: ohos.permission.CAMERA, // 可选扫码功能 reason: 用于扫描商品条形码或二维码, usedScene: { abilities: [ScanAbility], when: inuse } } // 严禁包含READ_CONTACTS, READ_CALL_LOG, SEND_SMS等无关权限 ] } }步骤3功能完整性测试覆盖所有核心路径启动 - 浏览商品 - 加入购物车 - 提交订单 - 支付沙箱 - 查看订单。测试所有按钮、链接、表单。确保在无网络、弱网络环境下有友好提示。3.2 构建与签名生成正式HAP包步骤1生成签名证书# 使用DevEco Studio生成.p12证书和.csr请求文件 # 或使用命令行需要keytool keytool -genkeypair -alias harmony_app -keyalg RSA -keysize 2048 -validity 3650 -keystore harmony_app.p12 -storetype PKCS12步骤2在AGC创建应用并上传证书登录AGC控制台创建应用。在“我的项目” - “应用发布” - “证书管理”中上传CSR文件获取.cer证书。步骤3配置签名信息在DevEco Studio中选择Build-Generate Key and CSR导入.cer证书和.p12文件生成签名配置。步骤4构建Release包选择Build Variants为release。勾选Minify代码混淆和Shrink Resources资源压缩。执行Build-Build Hap(s)。3.3 AGC后台配置填写应用信息步骤1基本信息应用名称简洁易记如“鸿蒙优选”。应用分类购物 - 电商。应用简介100字以内突出核心卖点。例“鸿蒙优选基于HarmonyOS NEXT打造的极致购物体验支持跨设备流转、AI智能推荐。”应用介绍详细描述功能、特色、更新日志。支持富文本可插入图片。步骤2素材上传图标1024x1024 PNG无圆角无透明通道无白边。截图至少3张最多5张。分辨率手机1080x2340、平板1920x1200、车机1920x720。严禁包含其他品牌水印、模拟器边框、个人信息。应用视频可选15-30秒展示核心功能。MP4格式无声音或配乐。步骤3隐私与权限填写隐私政策URL。逐一确认权限用途确保与module.json5一致。步骤4测试账号提供至少一个有效的测试账号和密码。确保账号包含所有必要的权限如查看订单、支付。在备注中说明账号的使用场景。3.4 提交审核与灰度发布步骤1提交审核上传Release HAP包。确认所有信息无误后点击“提交审核”。审核周期通常为1-3个工作日。步骤2应对审核反馈若通过恭喜准备上架。若被拒仔细阅读拒审理由。示例拒审理由“应用启动后在同意隐私政策前已向https://api.xxx.com发送网络请求。”对策修改代码确保网络请求在用户同意隐私政策后发送。回复审核意见说明修改内容并重新提交。步骤3灰度发布分阶段发布在“版本管理”中选择“灰度发布”。设置灰度比例如5%。监控灰度版本的崩溃率、ANR率、用户反馈。若无问题逐步扩大比例至100%。3.5 商业化配置IAP如果电商Demo包含虚拟商品如会员、电子书需配置IAP。// 查询商品信息 async function queryProducts(): Promisevoid { const productIds [vip_monthly, coins_100]; const result await iap.queryProducts(productIds, inapp); // inapp或subs console.log(商品列表:, result.products); } // 发起购买 async function buyProduct(productId: string): Promisevoid { try { const order await iap.createPurchaseOrder(productId); const paymentResult await iap.pay(order); console.log(支付结果:, paymentResult); // 发放权益 } catch (err) { console.error(购买失败:, err); } }AGC配置在“盈利” - “应用内支付”中创建商品设置价格和类型。四、踩坑记录官方文档没写的上架细节“僵尸”权限即使代码中没有使用某权限只要在module.json5中声明就需要提供理由。解决方案定期使用DevEco Studio的“Inspector”检查未使用的权限并移除。隐私政策的“地域性”如果应用面向欧盟隐私政策必须符合GDPR面向加州需符合CCPA。AGC会根据分发地区检查。解决方案使用AGC合规服务的多语言、多法规模板。截图的“纯净度”审核员对截图要求极高。截图不能包含顶部状态栏的时间不是“9:41”苹果梗。底部导航栏的“Home Indicator”样式不对。模拟器的黑色边框。任何个人手机号、邮箱、地址。其他应用的图标或名称。测试账号的“有效性”审核员可能会在半夜测试你的应用。如果测试账号过期或需要短信验证码审核会被拒。解决方案提供长期有效的账号或使用“万能验证码”仅限测试环境。审核周期的“玄学”周五提交的审核通常要等到下周中。月初月末是审核高峰期。解决方案预留充足的审核时间避开高峰期。