DevEco Studio 模块使用全指南

一、模块类型概述

二、添加新模块（Add New Module）

• 入口路径：

• 右键工程根目录 >New > Module

• 菜单 File > New > Module

• 操作步骤：

1. 选择模板（如 Empty Ability 或 Shared Library）。

2. 配置模块信息：

• Module name：不能与工程名重复（如​​feature_payment​​）。

• Module type：选择​​Entry​​​ 或​​Feature​​​（默认​​Feature​​）。

• Device type：勾选支持的设备（如 Phone、Tablet）。

3. 完成创建后，模块会生成独立的​​src​​​、​​resources​​​ 和​​module.json5​​。

三、模块功能扩展：添加 Ability 与 Page

1. 添加 Ability（核心组件）

• Stage 模型（主推） ：

• UIAbility：带界面的组件（如页面、弹窗）。

• 右键模块​​ets​​ 目录 >New > Ability > UIAbility，设置名称并勾选 Launcher ability（桌面图标）。

• ExtensionAbility：无界面的扩展功能（如后台服务、数据备份）。

• 右键模块 >New > Extension Ability，选择类型（如 BackupAbility）。

• FA 模型（兼容旧项目） ：

• 右键模块​​js​​ 目录 >New > Ability，选择 Page Ability 或 Service Ability。

2. 添加 Page（页面）

• 适用场景：ArkTS Stage 模型工程，用于构建多页面应用。

• 操作步骤：

1. 右键模块​​src/main/ets/pages​​ >New > Page。

2. 选择模板（如 Empty Page 或 Map Page），输入名称（如​​OrderPage​​）。

3. 生成文件​​OrderPage.ets​​，通过路由跳转：

import router from '@ohos.router';router.pushUrl({ url: 'pages/OrderPage' }); // 跳转至新页面

四、添加服务卡片（Service Widget）

1. 创建流程

1. 右键模块 > New > Service Widget

2. 选择卡片模板：

• 2x2

• 2x4

• 4x4

3. 配置参数（可默认） ：

4. 生成文件：

resources/base/profile/  └── weather_widget.json  // 卡片配置文件ets/widget/  └── WeatherWidget.ets   // 卡片逻辑

2. 卡片配置文件示例

{  "forms": [    {      "name": "widget",      "displayName": "$string:widget_display_name",      "description": "$string:widget_desc",      "src": "./ets/widget/pages/WidgetCard.ets",      "uiSyntax": "arkts",      "window": {        "designWidth": 720,        "autoDesignWidth": true      },      "colorMode": "auto",      "isDynamic": true,      "isDefault": true,      "updateEnabled": false,      "scheduledUpdateTime": "10:30",      "updateDuration": 1,      "defaultDimension": "1*2",      "supportDimensions": [        "1*2",        "2*2"      ]    }  ]}

五、导入示例工程（Import Sample）

1. 导入 Sample 工程（快速学习）

• 操作步骤：

1. 确保已安装 Git（菜单 File > Settings > Version Control > Git，测试连接）。

2. 欢迎页点击 More Actions > Import Sample，选择官方示例（如​​Preferences​​ 配置模块）。

3. 等待同步完成，查看模块结构（如​​entry​​​ 主模块 +​​feature_settings​​ 特性模块）。

• 注意：

• 网络受限需配置 Git 代理（​​git config --global http.proxy http://proxy:port​​）。

2. 删除模块

• 操作步骤：

1. 右键模块目录 >Delete，确认删除文件。

2. 手动清理工程级配置：

• ​​build-profile.json5​​ 中移除模块相关配置。

• ​​app.json5​​​（Stage）或​​config.json​​（FA）中删除模块引用。

六、模块开发最佳实践

1. 模块化设计原则

• 职责分离：

• ​​entry​​ 模块：仅包含启动逻辑和全局配置。

• ​​feature​​​ 模块：独立功能（如​​feature_login​​​、​​feature_share​​），通过接口与主模块通信。

• 资源复用：

• 公共资源（如字体、颜色）放在​​AppScope/resources​​ 目录，供所有模块共享。

• 私有资源存放在模块​​resources​​ 目录，避免命名冲突。

2. 跨模块通信

• EventBus：通过全局事件总线传递数据（如​​@AppStorage​​​ 或三方库​​EventCenter​​）。

• 接口暴露：在​​Library​​​ 模块中定义接口，​​Entry​​​/​​Feature​​ 模块实现：

// Library模块export interface PaymentService {  pay(amount: number): boolean;}// Feature模块实现export class AlipayService implements PaymentService { ... }

3. 构建与调试

• 单独构建模块：右键模块 >Build Module，生成独立​​.hap​​ 包（用于动态加载）。

• 调试特定模块：在工具栏选择模块名称，点击 Run 或 Debug（如​​entry​​​ 或​​feature_payment​​）。

##鸿蒙开发工具 ##DevEco Studio##商务 #