> 技术文档 > HarmonyOS 5休闲娱乐类应用上架全流程

HarmonyOS 5休闲娱乐类应用上架全流程


​HarmonyOS 5休闲娱乐应用上架全流程指南​

​一、上架前准备:账号认证与环境配置​
  1. ​开发者账号注册与认证​

    • ​注册要求​​:
      • 访问华为开发者联盟官网,完成企业/个人实名认证(企业需营业执照,个人需身份证)。
      • 休闲娱乐类应用若涉及支付功能(如会员订阅),​​必须完成企业认证​​并签署《支付服务协议》。
    • ​特殊资质​​:
      • 含直播功能需提供《信息网络传播视听节目许证》;含UGC内容需具备内容审核机制说明。
  2. ​开发环境搭建​

    • ​工具链配置​​:
      • 安装DevEco Studio 5.0+,勾选HarmonyOS SDK(API 12+)及Node.js 18+。
      • 验证环境:
        node -v # 需≥18.x ohpm -v # 包管理器需≥1.0.0 

​二、应用合规性核心要点​
  1. ​隐私政策与权限声明​

    • ​隐私政策页面​​:
      • 独立ArkUI页面展示,首次启动强制弹窗授权,拒绝后禁用核心功能(如视频播放)。
      • 需明确说明数据收集类型(如设备ID、观看历史)及第三方SDK(如广告平台)的数据使用范围。
    • ​权限精准声明​​(module.json5示例):
      \"requestPermissions\": [ { \"name\": \"ohos.permission.INTERNET\", \"reason\": \"加载在线视频资源\" }, { \"name\": \"ohos.permission.DISTRIBUTED_DATASYNC\", \"reason\": \"跨设备同步播放进度\" } ] 
  2. ​内容合规性​

    • 禁止出现暴力、赌博等违规内容,用户生成内容(如评论)需实时过滤敏感词。
    • 版权材料(如音乐/影视)需提供授权证明,并在应用描述中注明来源。

​三、应用签名与编译打包​
  1. ​签名证书生成​

    • ​步骤​​:
      1. DevEco Studio → Build > Generate Key and CSR → 创建.p12密钥库(有效期≥25年)。
      2. 登录AGC平台 → 证书管理 → 上传CSR文件 → 下载发布证书(.cer)和Profile文件(.p7b)。
    • ​配置签名​​(build-profile.json5示例):
      \"signingConfigs\": [{ \"name\": \"release\", \"material\": { \"storeFile\": \"entertainment.p12\", \"keyAlias\": \"release_key\", \"profile\": \"release.p7b\" } }] 
  2. ​包体积优化​

    • 主包(.app)≤2GB,子包按设备区分: ​​设备类型​​ ​​大小限制​​ 手机/智慧屏 ≤2GB 智能手表 ≤20MB 原子化服务 ≤10MB
    • 优化策略:
      • 资源:WebP图片+SVG图标(体积减少60%)。
      • 代码:启用ProGuard混淆,移除未使用库。

​四、AppGallery Connect(AGC)配置​
  1. ​应用信息填写​

    • ​关键字段​​:
      • 包名:全网唯一,与工程中bundleName完全一致。
      • 分类:选择“休闲娱乐”或“视频/音乐”。
    • ​素材规范​​: ​​类型​​ ​​要求​​ 应用图标 216×216px PNG(透明背景) 截图 ≥5张(1242×2208px)展示核心功能 演示视频 包含分布式流转场景演示
  2. ​支付与商业化​

    • ​支付集成​​:
      • 必须使用华为IAP SDK,禁用微信/支付宝独立集成。
      • 代码示例:
        import iap from \'@ohos.iap\'; iap.createPayment({ goodsId: \'vip_monthly\' }); 
    • ​广告合规​​:
      • 儿童内容禁止投放行为定向广告,需提供关闭入口。

​五、提交审核与发布策略​
  1. ​审核避坑指南​

    • ​高频驳回原因​​:
      • 隐私政策未说明第三方SDK数据收集。
      • 冷启动时间>1.5秒(优化建议:预加载JS Bundle)。
    • ​测试要求​​:
      • 提供测试账号(预置VIP权限)供审核团队验证支付功能。
  2. ​发布与监控​

    • ​发布选项​​:
      • ​开放式测试​​:向1,000名用户灰度发布,收集反馈后全量。
      • ​分阶段发布​​:首日5%用户,崩溃率<0.1%后逐步扩量。
    • ​数据分析集成​​:
      import hiAnalytics from \'@ohos.hiAnalytics\'; hiAnalytics.onEvent(\'video_play\', { duration: 120 }); 

​六、休闲娱乐类应用特殊要求​
  1. ​多设备适配​

    • ​响应式布局​​(示例代码):
      // 根据屏幕尺寸切换UI device.screen.onChange((info) => { if (info.width >= 1200) this.currentLayout = \'tv\'; // 智慧屏布局 }); 
    • ​分布式场景​​:
      • 支持“手机选片→智慧屏播放”流转,延迟需<200ms。
  2. ​性能与安全强化​

    • ​启动速度​​:冷启动≤800ms(关闭非必要后台服务)。
    • ​SO库加固​​:
      • 使用Virbox Protector对原生库加密,防止反编译(如视频解码算法)。

​上架自查清单​

​类别​​ ​​必查项​​ ​​账号​​ 企业认证完成 + 华为支付开通 ​​签名​​ 证书有效期≥25年,Profile包名匹配 ​​隐私合规​​ 独立政策页 + 动态权限申请逻辑 ​​设备兼容​​ 覆盖手机/智慧屏/手表(至少3款真机测试) ​​性能​​ 内存峰值≤80%系统限制,FPS≥55