HarmonyOS 鸿蒙Next中不同配置文件的区别，还有什么？module.json5、 oh-package.json5、 app.json5、 main_page.json

HarmonyOS 鸿蒙Next中不同配置文件的区别，还有什么？module.json5、 oh-package.json5、 app.json5、 main_page.json 在鸿蒙（HarmonyOS）开发中，不同配置文件承担着不同层级的职责，以下是核心区别对比：

1. 作用域与定位

• app.json5
  应用级配置，位于 AppScope目录。定义全局属性：

  {
    "app": {
      "bundleName": "com.example.app",  // 包名
      "vendor": "example",             // 开发商
      "versionCode": 1000000,          // 版本号
      "icon": "$media:icon",           // 应用图标
      "debug": false                   // 调试模式
    }
  }
  

  ▶ 影响整个应用，如权限、设备兼容性、多实例配置。

• module.json5
  模块级配置，位于模块的 src/main目录。定义模块能力：

  {
    "module": {
      "name": "entry",                 // 模块名
      "type": "entry",                 // 模块类型（entry/feature等）
      "abilities": [                   // 能力组件列表
        {"name": "EntryAbility", "srcEntry": "./ets/EntryAbility.ets"}
      ]
    }
  }
  

  ▶ 控制模块内 UIAbility/ExtensionAbility 组件及资源。

• oh-package.json5
  依赖管理配置，分两种：

  • 工程级（根目录）：管理全局依赖覆盖（overrides）、脚本（scripts）。
  • 模块级（模块根目录）：定义包信息与依赖：

    {
      "name": "@group/package",        // 包名（发布HAR必需）
      "version": "1.0.0",              // 遵循semver规范
      "dependencies": {                // 生产依赖
        "@library/utils": "^1.2.0"
      },
      "devDependencies": {}            // 开发依赖
    }
    

    ▶ 用于 OHPM 包管理，支持 HAR/HSP 发布。

• main_page.json
  页面级配置（非标准名，通常为 页面名.json）。定义单页面行为：

  {
    "window": {
      "navigationBarTextStyle": "black",  // 导航栏文字样式
      "backgroundTextStyle": "light"      // 下拉背景样式
    }
  }
  

  ▶ 控制具体页面的窗口样式、导航栏等，需与 UI 文件同目录。

2. 核心差异总结

3. 协作关系示例

flowchart LR
  A[app.json5] -->|全局配置| B(module.json5)
  B -->|模块能力| C[EntryAbility.ets]
  C -->|调用页面| D[main_page.json]
  E[oh-package.json5] -->|管理依赖| B

关键说明：

• app.json5与 module.json5是鸿蒙工程的强制性配置，缺失会导致编译失败。
• oh-package.json5仅在需要依赖管理或发布HAR包时使用。
• 页面级JSON文件（如 main_page.json）仅影响当前页面样式，不参与核心功能逻辑。