HarmonyOS之AbilityStage、UIAbility、WindowStage

🧩 一、核心组件功能与作用

1. AbilityStage：模块级容器

功能：管理 HAP 模块的生命周期和资源分配，全局响应系统事件（如配置变更、内存压力）。
核心作用 ：
- 模块初始化 ：在 HAP 首次加载时通过 onCreate() 预加载资源（如多语言文件、数据库连接池）。
- 事件响应 ：
  - onConfigurationUpdated()：响应系统语言/深色模式切换，更新模块级配置。
  - onMemoryLevel()：根据内存压力等级（如 COMPLETE）释放非关键资源（如清空缓存）。
- 启动模式拦截 ：通过 onAcceptWant() 管理 specified 模式的 Ability 启动，实现自定义实例复用逻辑。

代码示例（资源预加载与内存管理）：

typescript 复制代码

import { AbilityStage, AbilityConstant } from '@kit.AbilityKit';
export default class MyAbilityStage extends AbilityStage {
  private cacheMap: Map<string, any> = new Map();

  onCreate(): void {
    this.preloadCommonResources(); // 预加载多语言资源
  }

  onMemoryLevel(level: AbilityConstant.MemoryLevel): void {
    if (level === AbilityConstant.MemoryLevel.COMPLETE) {
      this.cacheMap.clear(); // 内存不足时释放缓存
    }
  }
}

2. UIAbility：交互逻辑核心

功能：管理界面生命周期、处理用户交互、实现跨页面导航。
核心作用 ：
- 生命周期管理 ：
  - onCreate()：初始化页面数据。
  - onForeground()：申请资源（如重新连接网络）。
  - onBackground()：保存状态并释放资源（如暂停动画）。
- 多实例模式 ：
  - singleton（单例）：全局唯一实例（如设置页）。
  - multiton（多实例）：每次启动新实例（如多个商品详情页）。
  - specified（指定实例）：通过 Key 复用特定实例（如聊天窗口）。
- 数据同步 ：通过 EventHub、AppStorage 实现跨组件通信。

代码示例（页面跳转与参数传递）：

typescript 复制代码

import { UIAbility } from '@kit.AbilityKit';
import { router } from '@ohos.router';

export default class ProductAbility extends UIAbility {
  onStart() {
    // 跳转到详情页并传递商品ID
    router.pushUrl({
      url: 'pages/Detail',
      params: { productId: '123' }
    });
  }
}

3. WindowStage：窗口渲染中枢

功能：管理窗口生命周期、加载 UI 内容、处理窗口级事件（如显示/隐藏）。
核心作用 ：
- 窗口绑定 ：
  - onWindowStageCreate()：加载 UI 组件（如 loadContent('pages/Index')）。
  - onWindowStageDestroy()：释放窗口相关资源（如关闭解码器）。
- 系统交互：控制全屏、分屏、窗口尺寸调整等行为。

代码示例（全屏控制）：

typescript 复制代码

import { UIAbility, window } from '@kit.AbilityKit';

export default class VideoAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage) {
    windowStage.loadContent('pages/Player', (err) => {
      if (err) return;
      windowStage.getMainWindow().then(win => {
        win.setFullScreen(true); // 播放页强制全屏
      });
    });
  }
}

🔄 二、三组件协作流程

1. 启动模块时序

阶段	AbilityStage	UIAbility	WindowStage
初始化模块	`onCreate()` 预加载资源	-	-
首次打开界面	-	`onCreate()` → `onStart()`	`onWindowStageCreate()`
切到前台	-	`onForeground()`	窗口事件 `Shown` → `Active`
切到后台	响应 `onMemoryLevel()`	`onBackground()`	窗口事件 `Hidden`
销毁模块	`onDestroy()` 回收资源	`onDestroy()`	`onWindowStageDestroy()`

2. 事件协作案例：系统语言切换

AbilityStage 的 onConfigurationUpdated() 捕获变更，更新模块级语言配置。

UIAbility 接收事件，通过 EventHub 通知所有页面重绘：

typescript 复制代码

// UIAbility中订阅配置变更
this.context.eventHub.on('langChange', () => {
  router.getActivePage()?.refreshText();
});

WindowStage 确保新语言下的布局适配（如阿拉伯语右对齐）。

🏗️ 三、综合案例：智能家居控制应用

场景描述

AbilityStage：预加载设备列表和房间配置。
UIAbility ：
- 主页面显示房间列表（singleton 模式）。
- 设备控制页（multiton 模式，每个设备独立实例）。
WindowStage：控制页全屏显示，退出时释放传感器资源。

代码实现

1. AbilityStage 预加载设备数据

typescript 复制代码

// MyAbilityStage.ets
onCreate(): void {
  const deviceList = preloadDeviceConfig(); // 从云端加载设备配置
  AppStorage.setOrCreate('deviceList', deviceList);
}

2. UIAbility 管理设备控制页

typescript 复制代码

// DeviceAbility.ets
onStart() {
  const deviceId = router.getParams()?.['deviceId'];
  const device = AppStorage.get('deviceList').find(d => d.id === deviceId);
  this.initDeviceControl(device); // 初始化设备控制逻辑
}

3. WindowStage 全屏与资源释放

typescript 复制代码

// DeviceAbility.ets
onWindowStageCreate(windowStage: window.WindowStage) {
  windowStage.loadContent('pages/DeviceControl', () => {
    windowStage.getMainWindow().setFullScreen(true);
  });
}

onWindowStageDestroy() {
  releaseSensorResources(); // 释放温度/湿度传感器连接
}

配置变更响应流程

当用户切换深色模式时：

AbilityStage → onConfigurationUpdated() → 更新模块主题色。
UIAbility → 通过 EventHub 通知所有页面切换主题。
WindowStage → 调整窗口亮度以适应深色模式。

💎 总结

AbilityStage ：模块级沙盒，管理全局资源与事件。
UIAbility ：交互中枢，处理页面生命周期与导航。
WindowStage ：渲染引擎，打通系统窗口与UI内容 。
三者通过分层协作（模块→交互→渲染），实现鸿蒙应用的高效运行。开发者需在 module.json5 中正确配置入口（如 srcEntry），并在代码中合理分配职责。