鸿蒙 应用发布准备工作(一)

一、准备应用软件包

准备好应用软件包并完成自检,确保 APP 包满足以下要求:

1. APP包名

软件包中设置的应用包名必须与创建 HarmonyOS 应用时配置的包名一致。

2. APP包签名

在 DevEco Studio 中编译发布包时,签名使用的是发布证书和发布 Profile。

3. APP包大小不超过 4GB。

4. APP包中HAP包大小

上传 APP 包后,AGC 将解析检测 APP 包中的 HAP 包大小 ,并根据 HAP 包声明支持的设备类型判断 HAP 包大小是否满足条件。如 APP 包大小符合条件,但 HAP 包超过上限 ,系统会提示 HAP 包过大 ,无法成功上传 APP 包。

不同设备类型的 HAP 包大小限制:

设备类型 HAP包大小上限
手机、平板或 PC/2in1 设备 不能超过 4GB
智能手表、智慧屏 不能超过 2GB
运动手表 不能超过 20MB

单设备 vs 多设备的判断规则:

场景 规则
支持单设备的 HarmonyOS 应用软件包 HAP 包大小不能超过对应设备类型的上限 。 例如,HarmonyOS 应用软件包仅支持运动手表,则 HAP 包不能超过 20MB
支持多设备的 HarmonyOS 应用软件包 • 如果 APP 包中的单个 HAP 包支持单个设备 ,则 HAP 包大小不能超过对应设备类型的上限 • 如果 APP 包中的单个 HAP 包支持多个设备 ,则 HAP 包大小不能超过这多个设备类型上限的最小值

5. APP包中HAP包类型

应用包内所有 HAP 包都必须是非免安装类型,即:

应用模型 检查要求
FA 模型 需保证每个 HAP 包的 src/main/config.json 文件中 installationFree 字段值均为 false
Stage 模型 需保证 AppScope/app.json5 文件的 bundleType 字段值为 app (无 bundleType 字段则默认为 app 类型)

6. API Level

APP 包使用的 API Level ≥ 10。

7. APP包中内容

API Level ≥ 11 时,不可包含调试信息 ,检查包内所有 HAP/HSP 包的 module.json 文件,确保 debug 字段值不为 true。

另外:

app.json5 文件中的 label 值不得为空 ,且 Entry 同级目录下不得存在两个同名的文件夹或文件。

四、准备发布素材

准备项 发布中国大陆地区的应用 发布非中国大陆地区的应用
支持的语种,适配各语种的应用素材 涉及 涉及
为应用详情页准备应用图标、应用介绍截图和视频 涉及 涉及
隐私权限说明 涉及 涉及
隐私声明 涉及 涉及
电子版权证书 涉及 不涉及
应用版权证书或代理证书 涉及 不涉及

五、发布前自检清单

软件包检查项

序号 检查项 要求
1 APP包名 与创建 HarmonyOS 应用时配置的包名一致
2 APP包签名 使用发布证书和发布 Profile
3 APP包大小 ≤ 4GB
4 HAP包大小 手机/平板/PC:≤4GB 智能手表/智慧屏:≤2GB 运动手表:≤20MB 多设备场景取最小值
5 HAP包类型 非免安装类型 FA:installationFree = false Stage:bundleType = app
6 API Level ≥ 10
7 包内内容 API Level ≥ 11 时无调试信息(debug ≠ true) label 值不为空 Entry 同级目录无同名文件夹或文件

素材检查项

序号 检查项 适用地区
1 多语种应用素材 中国大陆 + 非中国大陆
2 应用图标、截图、视频 中国大陆 + 非中国大陆
3 隐私权限说明 中国大陆 + 非中国大陆
4 隐私声明 中国大陆 + 非中国大陆
5 电子版权证书 中国大陆
6 应用版权证书或代理证书 中国大陆

六、闭坑

  1. HAP包大小是最容易踩的坑 :APP 包不超 4GB 不代表能上传成功,AGC 会逐个解析 HAP 包大小 ,超限直接提示"HAP 包过大"。特别是多设备场景 ,单个 HAP 支持多设备时,要取多个设备类型上限的最小值,别只看自己关心的那个设备。

  2. 免安装类型必须关闭:

    • FA 模型:installationFree 必须为 false

    • Stage 模型:bundleType 必须为 app

    • 这两项不满足,包可能无法正常上架。

  3. API Level ≥ 11 时不能带调试信息 :检查所有 HAP/HSP 包的 module.json,确保 debug 不为 true,这是很容易被忽略的细节。

  4. label 不能为空 + Entry 同级不能有同名文件夹/文件:属于比较容易忽略的"小坑",打包前顺手检查一下。

  5. 隐私声明可以托管 :没有自有隐私政策网站的,可以提前用 AGC 的隐私声明托管服务生成。

  6. 建议先看三份材料:应用审核指南、应用审核 FAQ、上架检测 FAQ,这三份是了解上架规则的入口,能少走弯路。

相关推荐
爱写Bug的浮游19 小时前
初识仓颉:5 分钟看懂核心语法
harmonyos·编程语言
程序猿追1 天前
鸿蒙 PC 的 Ionic 工单有两个错误,按下生成后光标该去哪儿
华为·harmonyos
KevinChaos1 天前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji2 天前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207412 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白2 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方2 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追2 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追3 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos
jianqiang.xue3 天前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai