网站导航
> 技术文档 > HarmonyOS之AbilityStage、UIAbility、WindowStage_.uiability和windowstate区别

HarmonyOS之AbilityStage、UIAbility、WindowStage_.uiability和windowstate区别

网友: 技术文档 2025-09-03 03:24:06

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

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

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

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 实现跨组件通信。

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

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()：释放窗口相关资源（如关闭解码器）。
    • 系统交互：控制全屏、分屏、窗口尺寸调整等行为。

代码示例（全屏控制）：

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. 事件协作案例：系统语言切换
  1. AbilityStage 的 onConfigurationUpdated() 捕获变更，更新模块级语言配置。
  2. UIAbility 接收事件，通过 EventHub 通知所有页面重绘： 
    // UIAbility中订阅配置变更this.context.eventHub.on(\'langChange\', () => { router.getActivePage()?.refreshText();});
  3. WindowStage 确保新语言下的布局适配（如阿拉伯语右对齐）。

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

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

1. AbilityStage 预加载设备数据

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

2. UIAbility 管理设备控制页

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

3. WindowStage 全屏与资源释放

// DeviceAbility.etsonWindowStageCreate(windowStage: window.WindowStage) { windowStage.loadContent(\'pages/DeviceControl\', () => { windowStage.getMainWindow().setFullScreen(true); });}onWindowStageDestroy() { releaseSensorResources(); // 释放温度/湿度传感器连接}
配置变更响应流程

当用户切换深色模式时：

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

💎 总结

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

相关问题