一、Module的核心定位与类型体系
在HarmonyOS应用开发中，Module是构成应用/元服务的基本功能单元，承载着源代码、资源文件、第三方库及配置文件，支持独立编译与运行。一个工程可包含多个Module，按功能划分为Ability（能力模块）和Library（库模块）两大类，细分包括：
-
Entry：应用主模块，作为唯一入口（每个工程最多1个）。
-
Feature：动态特性模块，支持按需加载（如插件化功能）。
-
Har/Shared：库模块（前者为静态库，后者为动态共享库）。
关键特性：
- Stage模型与FA模型的Module不兼容，导入时需严格匹配开发模型。
- 通过module.json5配置模块类型、设备适配及分发规则。
二、添加Module的全场景操作指南
（一）创建新Module：三种模式灵活选择
1. 根目录创建（适合单一功能模块）
- 操作路径：
右键工程根目录 → New > Module → 选择模板（如Empty Ability）。
- 配置要点：
- Module名称：不可与工程名重复，建议以功能命名（如“accountFeature”）。
- Module类型：Ability模块需选择Entry/Feature（Entry仅限1个）。
- 设备类型：Feature模块需与工程已有设备类型一致，Entry可新增适配设备（如同时支持手机和平板）。
2. 子目录创建（适合分类管理）
- 操作路径：
先创建目录（如“featureModules”）→ 右键目录 → New > Module。
- 适用场景：
按功能模块（如支付、社交）或设备类型（手机/平板）分组管理，提升工程可读性。
3. 模板选择与高级配置
-
Ability模板：需设置Ability名称及Exported属性（控制是否可被其他应用调用）。
-
Library模板：勾选“Enable native”可创建支持C/C++调用的共享库。
（二）导入外部Module：跨工程协作利器
- 支持场景：
- 导入同模型（Stage/FA）的Module文件夹或ZIP包。
- 通过build-profile.json5的srcPath字段引用外部Module（不复制代码，仅建立引用）。
- 操作步骤：
File > New > Import > Import Module → 选择目标路径 → 配置编译依赖。
（三）分发规则配置：精准适配多设备
当同一设备类型存在多个Entry模块（如适配不同屏幕形状）时，需通过distroFilter规则实现应用市场精准分发。
1. Stage模型配置
- 文件路径：
entry/src/main/resources/profile/xxx.json
- 核心标签：
json
{
"distributionFilter": {
"screenShape": { "policy": "include", "value": ["circle", "rect"] }, // 屏幕形状（圆形/矩形）
"screenDensity": { "policy": "exclude", "value": ["ldpi"] }, // 排除低密度屏幕
"countryCode": { "policy": "include", "value": ["CN"] } // 仅限中国地区分发
}
}
- 关联配置：在module.json5中指定分发文件：
json
{
"metadata": [
{ "name": "ohos.module.distro", "resource": "$profile:distro_filter_config" }
]
}
2. FA模型配置
直接在config.json的module字段中添加distroFilter，示例：
json
"distroFilter": {
"apiVersion": { "policy": "include", "value": ["8", "9"] } // 仅支持API 8/9设备
}
三、Module管理的最佳实践与避坑指南
（一）删除Module：彻底清理与依赖解除
- 操作步骤：
右键模块 → Delete → 确认删除（需注意：删除后需手动清理build-profile.json5中的残留配置）。
- 注意事项：
- 若模块包含资源引用，需先解除其他模块依赖，避免编译报错。
- 动态引用的外部Module（如通过srcPath）需同时删除引用配置。
（二）多Module协作开发规范
1. 命名约定：
- Entry模块：以“app”或“entry”结尾（如“mainEntry”）。
- Feature模块：以“feature”开头并注明功能（如“paymentFeature”）。
2. 依赖管理：
- 通过build.gradle（FA模型）或dependencies字段（Stage模型）声明模块间依赖。
- 避免循环依赖，优先采用单向依赖架构（如基础库 → 功能模块 → Entry）。
3. 版本控制：
- 对Library模块使用语义化版本（如“1.0.0”），通过build-profile.json5锁定版本号。
四、总结：从模块管理到架构设计
Module的灵活运用是HarmonyOS应用架构设计的基础，通过合理划分Entry/Feature/Shared模块，结合分发规则实现多设备适配，可显著提升开发效率与应用性能。建议在实践中：
1. 遵循单一职责原则：每个Module专注单一功能，避免过度耦合。
2. 优先使用动态特性模块（Feature）：按需加载功能，减少应用包体积。
3. 建立模块版本管理机制：通过AGC或代码仓库管理外部Module的迭代。
掌握Module的全生命周期管理技巧，不仅能解决日常开发中的配置问题，更能为复杂应用的架构设计奠定坚实基础。随着HarmonyOS生态的发展，模块化开发将成为跨设备协同场景下的核心竞争力之一。
