一、模块类型概述

二、添加新模块（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##商务#