一句话记忆：身份（app）→ 功能（module）→ 入口（pages）→ 依赖（ohpm）→ 打包（build）

在鸿蒙应用开发中，配置文件承担着定义应用元数据、组件关系、构建规则等核心作用，是构建应用架构的基石。以下对关键配置文件进行系统性解析：

一、应用级全局配置（app.json5）

1.基础标识信息

• bundleName：应用唯一标识符（反向域名格式，如com.example.app），用于系统级应用识别
• vendor：开发者组织/厂商信息，与应用商店分发体系关联
• versionCode/versionName：构成版本管理双因素，前者用于内部版本追踪，后者面向用户展示

2.设备适配策略

• targetDeviceTypes：声明支持的设备类型（phone/tablet/tv/wearable等），决定应用在设备市场的可见性
• deviceSpecificConfigs：针对不同设备的差异化配置（如平板端采用分栏布局、穿戴设备启用低功耗模式）

3.API版本管理

• minAPIVersion：最低兼容的API版本，控制老旧设备的安装限制
• targetAPIVersion：目标开发版本，决定可使用的API功能集合
• compatibleAPIVersion：向后兼容版本，确保新功能在老设备上的降级策略

二、模块级功能配置（module.json5）

该文件描述功能模块的组件架构和运行特征，是鸿蒙原子化服务的核心载体：

1.模块元数据

name：模块的工程名称（与代码目录关联）

type：模块类型（entry/feature/har），分别对应主模块/功能模块/静态库

description：模块功能说明，用于IDE可视化展示

2.组件注册中心

abilities：声明UIAbility（可视化界面单元）和ExtensionAbility（后台服务单元）

• UIAbility：定义页面栈管理策略、启动模式（standard/singleton模式）
• ExtensionAbility：配置后台服务类型（如FormExtension提供卡片能力）

forms：服务卡片配置，包含卡片尺寸、刷新策略、数据源绑定

3.权限管理体系

1. requestPermissions：声明应用运行所需的权限集合
2. 权限分级配置：

• normal：普通权限（自动授予）
• system_basic：系统基础权限（需动态申请）
• system_core：核心系统权限（需签名校验）

三、页面入口配置（main_pages.json）

该文件是应用界面导航的“路线图”，管理页面加载优先级：

• src字段按序排列启动页路径，决定应用冷启动时的首个加载页面
• 支持动态路径注入，实现AB测试分流、灰度发布等场景
• 与模块的pages目录结构强关联，确保路径解析的正确性

四、依赖管理配置（oh-package.json5）

作为鸿蒙生态的依赖枢纽，该文件遵循OpenHarmony Package Manager规范：

1.工程元数据

• name：包名（需符合ohpm仓库命名规范）
• version：语义化版本号（major.minor.patch）
• description：模块功能摘要，影响仓库搜索排名

2.依赖控制

• dependencies：生产环境依赖（如UI组件库、网络框架）
• devDependencies：开发工具链依赖（如代码检测工具、构建插件）
• 版本锁定策略：支持^1.2.3（兼容小版本）、~1.2.3（锁定补丁版）等语法

五、构建流程配置（build-profile.json5）

该文件是编译系统的“操作手册”，控制构建过程的关键参数：

1.构建目标配置

• targets：指定输出产物类型（如HAP/HSP）
• artifactType：选择调试版（含符号表）或发布版（代码混淆）

2.优化策略

• minifyEnabled：启用ProGuard代码压缩
• shrinkResources：自动移除未使用资源
• signingConfig：配置应用签名证书（调试证书/发布证书分离）

3.多环境配置

• 支持profiles字段定义开发、测试、生产等多套环境变量
• 动态注入API端点、功能开关等差异化参数

六、配置文件协同机制

1.层级关系

app.json5定义应用全局属性 → module.json5配置模块能力 → main_pages.json控制界面入口，形成三级配置体系

2.编译联动

build-profile.json5读取各模块配置，生成最终HAP包 → oh-package.json5确保依赖库的版本一致性

3.动态覆盖

通过resources/base/profile/目录实现多设备配置覆盖，满足“一次开发，多端部署”需求

这些配置文件共同构成了鸿蒙应用的“基因图谱”，我们可以通过合理配置可显著提升开发效率、确保跨设备兼容性，并为后续维护扩展奠定坚实基础。理解其内在关联，是构建高质量鸿蒙应用的必要前提。

概要总结：

1.app.json5

• 全局身份标识（包名/厂商/版本）
• 设备适配策略（支持类型/差异化配置）

2.module.json5

• 模块属性（名称/类型/设备兼容）
• 组件注册（界面/服务）
• 权限声明（普通/系统级）

3.main_pages.json

• 启动页优先级排序
• 页面路径映射（对应模块配置）

4.oh-package.json5

• 依赖管理（组件库/工具链版本）
• 遵循ohpm包管理规范

5.build-profile.json5

• 构建目标（产物类型/环境）
• 优化设置（压缩/签名）

一句话记忆：身份（app）→ 功能（module）→ 入口（pages）→ 依赖（ohpm）→ 打包（build）