HarmonyOS鸿蒙Next中应用或元服务bundleName不可缺省

HarmonyOS鸿蒙Next中应用或元服务bundleName不可缺省

概述

应用/元服务bundleName不可缺省，是指在HarmonyOS应用或元服务的配置中，bundleName字段必须明确指定且不能为空。该字段用于唯一标识应用或元服务的Bundle名称，是系统识别和管理应用的核心属性之一。

设计原则

应用/元服务静态检查app.json5配置文件中bundleName字段不可缺省。

应用：定义推荐采用反域名形式命名（如“com.example.demo”，建议第一级为域名后缀com，第二级为厂商/个人名，第三级为应用名，也可以多级）；

元服务：由固定前缀com.atomicservice加上元服务的appid确定。

典型案例

您的应用bundleName缺省，不符合审核标准。

{
  "app": {
    // bundleName字段不可缺省
    "bundleName": "",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "icon": "$media:layered_image",
    "label": "$string:app_name",
    "description": "$string:description_application",
    "minAPIVersion": 9,
    "targetAPIVersion": 9,
    // ...
  }
  //...
}

修改指引

应用/元服务静态检查app.json5配置文件中bundleName字段不可缺省，详情见app.json5配置文件。

应用上架前迭代版本测试可使用DevEco Testing应用上架预检功能在本地设备/虚拟机提供黑盒专业测试能力，提前发现上架基础体验类问题，提升上架审核效率。

应用上架提审前可使用云测试应用上架预检功能在云端提供远程黑盒专业测试，包含多品类，多设备，多OS的兼容测试能力，提前发现上架基础体验类问题，提升上架审核效率。


更多关于HarmonyOS鸿蒙Next中应用或元服务bundleName不可缺省的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

在HarmonyOS Next中，bundleName是应用或元服务在AppGallery Connect上架的唯一标识，必须配置。它位于module.json5文件的module对象下，格式通常为反向域名+模块名。缺少bundleName会导致应用无法正确安装、识别和分发。

更多关于HarmonyOS鸿蒙Next中应用或元服务bundleName不可缺省的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中，bundleName 是应用或元服务的唯一标识符，必须在 app.json5 配置文件中明确指定，不可为空。这是系统识别、管理和分发应用的基础。

关键点：

  • 唯一性：bundleName 在整个应用生态中必须唯一，避免冲突。
  • 命名规范：
    • 应用：推荐使用反域名形式，如 com.example.demo。
    • 元服务：固定前缀 com.atomicservice 加上元服务的 appid。
  • 审核要求：缺省或为空会导致应用无法通过上架审核。

修改示例： 在 app.json5 中，确保 bundleName 字段有有效值：

{
  "app": {
    "bundleName": "com.example.demo",
    // 其他配置...
  }
}

检查工具：开发阶段可使用 DevEco Testing 或云测试进行预检，提前发现配置问题，提升审核效率。

确保 bundleName 正确配置是应用开发的基础步骤，直接影响应用的部署和分发。

回到顶部