第十七讲_HarmonyOS应用开发Stage模型应用组件

1. 应用级配置

应用级配置在AppScope目录下的app.json5配置文件中。

• bundleName：用于标识应用的唯一性。
• icon：应用图标
• label：应用名称
• versionCode：用于标识应用的版本号
• versionName：版本号的文字描述

{
  "app": {
    "bundleName": "com.dake.myapplication",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    // 读取resouces/media目录下app_icon
    "icon": "$media:app_icon",
    // 读取resouces/element目录下string.json文件中的app_name
    "label": "$string:app_name"
  }
}

2. Module级配置

Module级配置在Module_Name/src/main目录下的module.json5配置文件中。

• abilities：配置Ability
• deviceTypes：表明当前的Module支持在该设备上运行。
• requestPermissions：该标签用于声明需要申请权限的名称、申请权限的原因以及权限使用的场景。

{
  "module": {
  	// module的名称
    "name": "entry",
    // module的类型
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone",
      "tablet"
    ],
    "deliveryWithInstall": true,
    "installationFree": false,
    "pages": "$profile:main_pages",
    "abilities": [
      {
        "name": "EntryAbility",
        // 指定UIAbility的类路径
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "description": "$string:EntryAbility_desc",
        // 入口图标
        "icon": "$media:icon",
        // 入口名称
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "action.system.home"
            ]
          }
        ]
      }
    ]
  }
}

3. Stage模型的组件

3.1 AbilityStage

AbilityStage是一个Module级别的组件容器：

• 应用的HAP在首次加载时会创建一个AbilityStage实例，可以对该Module进行初始化等操作。
• 一个Module拥有一个AbilityStage

一个Module编译后生成一个HAP文件，详细了解可以查看另一篇博文：HarymonyOS应用程序包介绍

3.1.1 AbilityStage的创建和配置

DevEco Studio默认工程中未自动生成AbilityStage，如需要使用AbilityStage的能力，可以手动新建一个AbilityStage文件。

1. 创建一个 ArkTS File
2. 文件中创建一个类，并继承AbilityStage
3. 在Module配置文件module.json5中配置

{
  "module": {
  	// srcEntry指定AbilityStage的类路径
    "srcEntry": "./ets/myabilitystage/MyAbilityStage.ets",
  }
}

3.1.2 AbilityStage的生命周期回调

• onCreate()：在开始加载对应 Module 的第一个 UIAbility 实例之前会先创建 AbilityStage，并在 AbilityStage 创建完成之后执行其 onCreate()生命周期回调。

3.1.3 AbilityStage的事件回调：

• onAcceptWant()：UIAbility 指定实例模式（specified）启动时候触发的事件回调。
• onConfigurationUpdated()：当系统全局配置发生变更时触发的事件，系统语言、深浅色等，配置项目前均定义在 Configuration 类中。
• onMemoryLevel()：当系统调整内存时触发的事件。

3.2 UIAbility

UIAbility组件是一种包含UI的应用组件，主要用于和用户交互。

• UIAbility组件是系统调度的基本单元，为应用提供绘制界面的窗口。
• 一个应用可以包含一个或多个UIAbility组件

3.2.1 UIAbility生命周期

UIAbility的生命周期包括Create、Foreground、Background、Destroy四个状态。

• Create状态为在应用加载过程中，UIAbility实例创建完成时触发，系统会调用onCreate()回调。
• 进入Foreground状态之前，系统会创建一个WindowStage。WindowStage创建完成后会进入onWindowStageCreate()回调；UIAbility实例切换至前台时触发onForeground()回调。
• UIAbility实例切换至后台时触发onBackground()回调。
• 在进入Destroy状态之前，UIAbility实例销毁之前，先进入WindowStage的onWindowStageDestroy()回调；UIAbility实例销毁时触发onDestroy()回调。

3.2.3 UIAbility启动模式

在Module的配置文件 module.json5 中配置

{
  "module": {
    "abilities": [
      {
        "launchType": "singleton"
      }
    ]
  }
}

• singleton 启动模式为单实例模式，默认启动模式。系统中只存在唯一一个该 UIAbility 实例。
• multiton 启动模式为多实例模式，每次调用 startAbility()方法时，都会在应用进程中创建一个新的该类型 UIAbility 实例。
• specified 启动模式为指定实例模式。