鸿蒙OS 在工程中添加Module
Module 是 HarmonyOS 应用的基本功能单元,包含了源代码、资源文件、第三方库及应用清单文件,每一个 Module 都可以独立进行编译和运行。一个 HarmonyOS 应用通常会包含一个或多个 Module,因此,可以在工程中,创建多个 Module,每个 Module 分为 Ability 和 Library (HarmonyOS Library 和 Java Library)两种类型。
如 HarmonyOS工程介绍,在一个 APP 中,对于同一类型设备有且只有一个 Entry Module,其余 Module 的类型均为 Feature。因此,在创建一个类型为 Ability 的 Module 时,遵循如下原则:
- 若新增 Module 的设备类型为已有设备时,则 Module 的类型将自动设置为“Feature”。
- 若新增 Module 的设备类型为当前还没有创建 Module,则 Module 的类型将自动设置为“Entry”。
新增 Module
- 通过如下两种方法,在工程中添加新的 Module。
- 方法1:鼠标移到工程目录顶部,点击鼠标右键,选择 New>Module,开始创建新的 Module。
- 方法2:在菜单栏选择 File > New > Module,开始创建新的 Module。
- 在 New Project Module 界面中,选择 Module 对应的设备类型和模板。
- 点击 Next,在 Module 配置页面,设置新增 Module 的基本信息。
- Module 类型为 Ability 或者 HarmonyOS Library 时,请根据如下内容进行设置,然后点击Next。
- Application/Library name:新增 Module 所属的类名称。
- Module name:新增模块的名称。
- Module Type:仅 Module 类型为 Ability 时存在,工具自动根据设备类型下的模块进行设置。
- Package name:软件包名称,可以点击 Edit 修改默认包名称,需全局唯一。
- Compatible SDK:兼容的 SDK 版本。
- Application/Library name:新增 Module 所属的类名称。
- Module 类型为 Java Library 时,请根据如下内容进行设置,然后点击 Finish 完成创建。
- Library Name:Java Library 类名称。
- Java package name:软件包名称,可以点击 Edit 修改默认包名称,需全局唯一。
- Java class name:class 文件名称。
- Create.gitignore file:是否自动创建 .gitignore 文件,勾选表示创建。
- 设置新增 Ability 或 HarmonyOS Library 的 Page Name。
若该 Module 类型为 Ability,需要设置 Visible 参数,表示该 Ability 是否可以被其它应用所调用。
- 勾选(true):可以被其它应用调用。
- 不勾选(false):不能被其它应用调用。
- 点击 Finish,等待创建完成后,可以在工程目录中查看和编辑新增的 Module。
删除 Module
为防止开发者在删除 Module 的过程中,误将其它的模块删除,DevEco Studio 提供统一的模块管理功能,需要先在模块管理中,移除对应的模块后,才允许删除。
- 在菜单栏中选择 File > Project Structure > Module**s,选择需要删除的 Module,点击按钮,并在弹出的对话框中点击Yes**。
- 在工程目录中选中该模块,点击鼠标右键,选中 Delete,并在弹出的对话框中点击 Delete。