从build-profile到oh-package读懂鸿蒙项目的每一行配置配置文件全景图五子棋/ ├── build-profile.json5 ← 项目级构建配置 ├── oh-package.json5 ← 项目级依赖管理 ├── hvigorfile.ts ← 构建脚本 ├── hvigor/hvigor-config.json5 ← Hvigor配置 ├── AppScope/app.json5 ← 应用清单 ├── entry/ │ ├── build-profile.json5 ← 模块级构建配置 │ ├── oh-package.json5 ← 模块级依赖管理 │ └── src/main/module.json5 ← 模块清单build-profile.json5项目级{ app: { signingConfigs: [], // 签名配置 products: [ { name: default, signingConfig: default, compatibleSdkVersion: 5.0.0(12), // 兼容SDK版本 runtimeOS: HarmonyOS, // 运行时OS targetSdkVersion: 6.1.1(24) // 目标SDK版本 } ], buildModeSet: [ { name: debug }, // 调试模式 { name: release } // 发布模式 ] }, modules: [ { name: entry, srcPath: ./entry, targets: [ { name: default, applyToProducts: [default] } ] } ] }关键字段解读compatibleSdkVersion应用最低支持的SDK版本低于此版本的设备无法安装targetSdkVersion应用目标SDK版本决定可用的API范围products可以定义多个产品如免费版/付费版每个产品可以有不同的签名和配置buildModeSet构建模式debug用于开发调试release用于发布oh-package.json5项目级{ modelVersion: 6.1.1, description: Gomoku game for HarmonyOS, dependencies: {}, devDependencies: { ohos/hypium: 1.0.21 } }modelVersion包管理模型版本dependencies运行时依赖devDependencies开发时依赖如测试框架ohos/hypium华为官方单元测试框架entry/build-profile.json5模块级{ apiType: stageMode, buildOption: {}, targets: [ { name: default, runtimeOS: HarmonyOS } ] }apiType有两个选项stageModeStage模型推荐本项目使用faModeFA模型旧版不推荐entry/oh-package.json5模块级{ name: entry, version: 1.0.0, description: Gomoku entry module, main: , author: , license: Apache-2.0, dependencies: {} }hvigorfile.ts// 项目级构建脚本exportdefault{system:require(ohos/hvigor-ohos-plugin).hapTasks}Hvigor是鸿蒙的构建工具使用TypeScript编写构建脚本比Gradle的Groovy更易调试。配置文件之间的关系app.json5 (应用身份) ↓ 定义了应用级别信息 module.json5 (模块能力) ↓ 定义了模块的Ability和页面 main_pages.json (页面路由) ↓ 注册了所有页面路径 build-profile.json5 (构建规则) ↓ 定义了如何编译 oh-package.json5 (依赖管理) ↓ 定义了项目依赖实际开发中的常见配置场景1. 修改应用名称编辑AppScope/resources/base/element/string.json{name:app_name,value:五子棋}2. 添加新页面在main_pages.json中注册{ src: [pages/Index, pages/NewPage] }3. 修改启动背景色编辑entry/src/main/resources/base/element/color.json{name:start_window_background,value:#F5F5DC}4. 适配深色模式创建dark/element/color.json覆盖特定颜色{name:start_window_background,value:#333333}总结鸿蒙项目的配置虽然文件多但每个文件职责单一app.json5管应用身份module.json5管模块能力build-profile.json5管构建规则oh-package.json5管依赖资源json管显示内容理解这些配置文件的职责边界是高效开发鸿蒙应用的基础。附