当前位置：首页 > article >正文

鸿蒙的 Stage 模型

article 2025/3/18 4:31:30

鸿蒙的 Stage 模型

在鸿蒙 Next 开发中，Stage 模型是应用开发的核心架构之一，它为开发者提供了一种高效、灵活的方式来构建分布式应用。本文将详细介绍鸿蒙 Stage 模型的基本概念、应用配置文件的使用、UIAbility 组件的介绍以及如何通过 Stage 模型开发复杂应用。

一、Stage 模型的基本概念

（一）什么是 Stage 模型？

Stage 模型是鸿蒙 HarmonyOS API 9 开始新增的应用模型，是目前主推且会长期演进的模型。在 Stage 模型中，应用组件（如 Ability）和窗口（Window）的管理通过 AbilityStage 和 WindowStage 类来实现，因此得名 Stage 模型。

（二）Stage 模型与 FA 模型的区别

与 FA（Feature Ability）模型相比，Stage 模型的主要区别在于：

资源共享：Stage 模型中，多个应用组件共享同一个 ArkTS 引擎实例，而 FA 模型中，每个应用组件独享一个 ArkTS 引擎实例。
内存占用：由于资源共享，Stage 模型在运行复杂应用时可以减少内存占用。

（三）Stage 模型的优势

组件间共享：应用组件之间可以方便地共享对象和状态。
分布式场景支持：更适合开发分布式场景下的复杂应用。

二、Stage 模型的应用配置文件

（一）应用包名配置

应用需要在工程的 AppScope 目录下的 app.json5 文件中配置 bundleName 标签，用于标识应用的唯一性。推荐采用反域名形式命名（如 com.example.demo）。

（二）图标和标签配置

图标和标签通常一起配置，分别对应 app.json5 和 module.json5 文件中的 icon 和 label 标签。

（三）Module 支持的设备类型配置

Module 支持的设备类型需要在 module.json5 文件中配置 deviceTypes 标签。

（四）Module 权限配置

Module 访问系统或其他应用受保护部分所需的权限信息需要在 module.json5 文件中配置 requestPermissions 标签。

三、Stage 模型的 UIAbility 组件

（一）UIAbility 组件简介

UIAbility 是一种包含 UI 的应用组件，主要用于与用户交互。一个应用可以有一个或多个 UIAbility，例如，在支付应用中，可以将入口功能和收付款功能分别配置为独立的 UIAbility。

（二）UIAbility 的配置

为使应用能够正常使用 UIAbility，需要在 module.json5 文件的 abilities 标签中声明 UIAbility 的名称、入口、标签等相关信息。

{
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background"
      }
    ]
  }
}

（三）指定 UIAbility 的启动页面

在 UIAbility 的 onWindowStageCreate 生命周期回调中，通过 WindowStage 对象的 loadContent 方法设置启动页面。

onWindowStageCreate(windowStage: window.WindowStage): void {
  windowStage.loadContent('pages/Index', (err) => {
    if (err.code) {
      hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
      return;
    }
    hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
  });
}

（四）获取 UIAbility 的上下文信息

UIAbility 类拥有自身的上下文信息，该信息为 UIAbilityContext 类的实例。通过 UIAbilityContext 可以获取 UIAbility 的相关配置信息。

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    let context = this.context;
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
  }
}