Stage 模型 - UIAbility 的启动模式

[cnwutianhao]

Stage 模型这样的应用，它在启动的时候会先准备 Ability Stage 舞台，接着呢，就可以基于它去创建 UIAbility 的实例，并去启动它。

UIAbility 组件启动模式 有四种：

• singleton
• standard
• multiton
• specified

修改模块的 module.json5 来改变启动模式：

{
  "module": {
    ...

    "abilities": [
      {
        ...

        "launchType": "singleton",
        
        ...
      }
    ]
  }
}

一、singleton 启动模式

👉 官方文档

singleton 是单实例的意思，所以这种模式对应的 UIAbility 不管你给它启动多少次，它只会存在唯一的实例。事实上，我们的应用默认 Ability 都是这种模式。

UIAbility 的实例其实对应到操作系统任务列表中的一个任务。所以，如果你的 Ability 是 singleton 这种模式，不管启动多少次，去查看手机的任务列表，会发现这个 Ability 在任务列表中只会存在一个任务。

---

运行日志：

1. 点击图标启动 app：

   Ability onCreate
   Ability onWindowStageCreate
   Ability onForeground
   

2. 点击 Home 回到桌面：

   Ability onBackground
   

3. 再次点击图标启动 app：

   Ability onForeground
   

二、standard、multiton 启动模式

👉 官方文档

在官网上管 standard 模式叫 multiton 模式，但是经过测试，这两种模式是不一样的。但是这两个模式又非常接近，这两种模式在每次启动 UIAbility 时都会创建一个新实例。

在 standard 模式当中，创建一个新的实例，之前那个旧的实例也会存在，也就是多个实例并存；而 multiton 模式则不一样，它在每次创建一个新实例，旧的实例则会被移除。

对于 standard 模式来讲，每创建一个新的实例，都会存在，那是不是意味着同一个 Ability 它的多个实例是并存的。因此在任务列表中会发现一个 Ability 可能会存在一个或多个任务。

---

multiton 运行日志：

1. 点击图标启动 app：

   Ability onCreate
   Ability onWindowStageCreate
   Ability onForeground
   

2. 点击 Home 回到桌面：

   Ability onBackground
   

3. 再次点击图标启动 app：

   Ability onCreate
   Ability onWindowStageCreate
   Ability onForeground
   

4. 点击任务列表

   发现 App 只存在一个实例
   

---

standard 运行日志：

1. 点击图标启动 app：

   Ability onCreate
   Ability onWindowStageCreate
   Ability onForeground
   

2. 点击 Home 回到桌面：

   Ability onBackground
   

3. 再次点击图标启动 app：

   Ability onCreate
   Ability onWindowStageCreate
   Ability onForeground
   

4. 点击任务列表

   发现 App 存在两个实例
   

三、specified 启动模式

👉 官方文档

specified 顾名思义就是指定的意思，在使用这种模式时，启动一个 UIAbility 时是需要指定一个 key，这个 key 会作为 UIAbility 实例的一个唯一标识。

所以，当启动时，会先看一下指定的这个 key 对应的 UIAbility 是否存在。如果不存在，就会创建一个新的 UIAbility 实例，然后把这个 key 作为这个实例的标识，下次再启动 UIAbility 时，还需要指定 key，还需要判断这个 key 对应的实例是否已经存在。如果已经存在，就可以直接把它唤醒，不用重新创建。

这种模式和 standard 模式有点像，就是一个 Ability 会存在多个实例，但是呢又不一样，在创建实例时可以指定 key，key 不存在才需要创建，key 存在就不用重复创建了，这样就可以快速的找到以前创建好的实例。

当前 UIAbility 调用 startAbility 方法拉起目标 UIAbility：

// 获取上下文
context = getContext(this) as common.UIAbilityContext

// 指定要跳转到 UIAbility 的信息
let want = {
    deviceId: '',
    bundleName: 'com.tyhoo.hmos.myapplication',
    abilityName: 'TestAbility',
    moduleName: 'entry',
    parameters: {
      instanceKey: this.getInstanceKey()
    }
}

// 尝试拉起目标 UIAbility 实例
this.context.startAbility(want)

• 调用一个全局的 getContext 方法，来获取 UIAbilityContext 的上下文对象。

• 拿到上下文之后，可以调用它的 startAbility 方法，从而来去拉起一个目标的 UIAbility，或者说把它的实例给创建好。

• 传入参数 want 来告诉具体拉起哪个实例。

  • deviceId：设备信息。如果什么都不传，代表的是本设备。
  • bundleName：包名/应用名。它是设备的唯一标识。
  • abilityName：目标 UIAbility 的名称。
  • moduleName：模块名。调用的 Ability 在哪个模块。
  • parameters：参数。

在 AbilityStage 的生命周期回调中为目标 UIAbility 实例生成 key：

export default class MyAbilityStage extends AbilityStage {
  onAcceptWant(want: Want): string {
    if (want.abilityName === 'TestAbility') {
      return `TestAbility_${want.parameters.instanceKey}`
    }
    return '';
  }
}

在 module.json5 配置文件中，通过 srcEntry 参数指定 AbilityStage 路径：

{
  "module": {
    ...

    "srcEntry": "./ets/myabilitystage/MyAbilityStage.ts"
  }
}