HarmonyOS 5休闲娱乐应用上架全流程指南
一、上架前准备:账号认证与环境配置
-
开发者账号注册与认证
- 注册要求:
- 访问华为开发者联盟官网,完成企业/个人实名认证(企业需营业执照,个人需身份证)。
- 休闲娱乐类应用若涉及支付功能(如会员订阅),必须完成企业认证并签署《支付服务协议》。
- 特殊资质:
- 含直播功能需提供《信息网络传播视听节目许证》;含UGC内容需具备内容审核机制说明。
- 注册要求:
-
开发环境搭建
- 工具链配置:
- 安装DevEco Studio 5.0+,勾选HarmonyOS SDK(API 12+)及Node.js 18+。
- 验证环境:
node -v # 需≥18.x ohpm -v # 包管理器需≥1.0.0
- 工具链配置:
二、应用合规性核心要点
-
隐私政策与权限声明
- 隐私政策页面:
- 独立ArkUI页面展示,首次启动强制弹窗授权,拒绝后禁用核心功能(如视频播放)。
- 需明确说明数据收集类型(如设备ID、观看历史)及第三方SDK(如广告平台)的数据使用范围。
- 权限精准声明(
module.json5
示例):"requestPermissions": [ { "name": "ohos.permission.INTERNET", "reason": "加载在线视频资源" }, { "name": "ohos.permission.DISTRIBUTED_DATASYNC", "reason": "跨设备同步播放进度" } ]
- 隐私政策页面:
-
内容合规性
- 禁止出现暴力、赌博等违规内容,用户生成内容(如评论)需实时过滤敏感词。
- 版权材料(如音乐/影视)需提供授权证明,并在应用描述中注明来源。
三、应用签名与编译打包
-
签名证书生成
- 步骤:
- DevEco Studio →
Build > Generate Key and CSR
→ 创建.p12密钥库(有效期≥25年)。 - 登录AGC平台 →
证书管理
→ 上传CSR文件 → 下载发布证书(.cer)和Profile文件(.p7b)。
- DevEco Studio →
- 配置签名(
build-profile.json5
示例):"signingConfigs": [{ "name": "release", "material": { "storeFile": "entertainment.p12", "keyAlias": "release_key", "profile": "release.p7b" } }]
- 步骤:
-
包体积优化
- 主包(.app)≤2GB,子包按设备区分:
设备类型 大小限制 手机/智慧屏 ≤2GB 智能手表 ≤20MB 原子化服务 ≤10MB - 优化策略:
- 资源:WebP图片+SVG图标(体积减少60%)。
- 代码:启用ProGuard混淆,移除未使用库。
- 主包(.app)≤2GB,子包按设备区分:
四、AppGallery Connect(AGC)配置
-
应用信息填写
- 关键字段:
- 包名:全网唯一,与工程中
bundleName
完全一致。 - 分类:选择“休闲娱乐”或“视频/音乐”。
- 包名:全网唯一,与工程中
- 素材规范:
类型 要求 应用图标 216×216px PNG(透明背景) 截图 ≥5张(1242×2208px)展示核心功能 演示视频 包含分布式流转场景演示
- 关键字段:
-
支付与商业化
- 支付集成:
- 必须使用华为IAP SDK,禁用微信/支付宝独立集成。
- 代码示例:
import iap from '@ohos.iap'; iap.createPayment({ goodsId: 'vip_monthly' });
- 广告合规:
- 儿童内容禁止投放行为定向广告,需提供关闭入口。
- 支付集成:
五、提交审核与发布策略
-
审核避坑指南
- 高频驳回原因:
- 隐私政策未说明第三方SDK数据收集。
- 冷启动时间>1.5秒(优化建议:预加载JS Bundle)。
- 测试要求:
- 提供测试账号(预置VIP权限)供审核团队验证支付功能。
- 高频驳回原因:
-
发布与监控
- 发布选项:
- 开放式测试:向1,000名用户灰度发布,收集反馈后全量。
- 分阶段发布:首日5%用户,崩溃率<0.1%后逐步扩量。
- 数据分析集成:
import hiAnalytics from '@ohos.hiAnalytics'; hiAnalytics.onEvent('video_play', { duration: 120 });
- 发布选项:
六、休闲娱乐类应用特殊要求
-
多设备适配
- 响应式布局(示例代码):
// 根据屏幕尺寸切换UI device.screen.onChange((info) => { if (info.width >= 1200) this.currentLayout = 'tv'; // 智慧屏布局 });
- 分布式场景:
- 支持“手机选片→智慧屏播放”流转,延迟需<200ms。
- 响应式布局(示例代码):
-
性能与安全强化
- 启动速度:冷启动≤800ms(关闭非必要后台服务)。
- SO库加固:
- 使用Virbox Protector对原生库加密,防止反编译(如视频解码算法)。
上架自查清单
类别 | 必查项 |
---|---|
账号 | 企业认证完成 + 华为支付开通 |
签名 | 证书有效期≥25年,Profile包名匹配 |
隐私合规 | 独立政策页 + 动态权限申请逻辑 |
设备兼容 | 覆盖手机/智慧屏/手表(至少3款真机测试) |
性能 | 内存峰值≤80%系统限制,FPS≥55 |