【HarmonyOS】鸿蒙开辟之Stage模子-UIAbility的启动模式——第4.4章 ...

---

UIAbility的启动模式简介

一共有四种:singleton,standard,specified,multion。在项目目次的:src/main/module.json5。默认开启模式为singleton(单例模式)。如下图

singleton（单实例模式）启动模式

每个UIAbility只存在唯一实例。任务列表中只会存在一个类似的UIAbility (会覆盖上一个实例)
代码实例:

1. {
2.    "module": {
3.      ...
4.      "abilities": [
5.        {
6.          "launchType": "singleton",
7.          ...
8.        }
9.      ]
10.   }
11. }

复制代码

standard（尺度实例模式）启动模式

每次启动UIAbility都会创建一个新的实例。在任务列表中可能存在一个或多个类似的UIAbility实例。新实例创建后，旧实例依然存在。
好处：实现多开效果
代码实例:

1. {
2.    "module": {
3.      ...
4.      "abilities": [
5.        {
6.          "launchType": "standard",
7.          ...
8.        }
9.      ]
10.   }
11. }

复制代码

multion (多实例模式) 启动模式

每次启动UIAbility都会创建一个新的实例。新实例创建后，旧实例会被移除。
场景: 用户在使用分屏功能时，希望使用两个差别应用（例如备忘录应用和图库应用）之间进行分屏，也希望能使用同一个应用（例如备忘录应用自身）进行分屏。
代码实例:

1. {
2.    "module": {
3.      ...
4.      "abilities": [
5.        {
6.          "launchType": "multion",
7.          ...
8.        }
9.      ]
10.   }
11. }

复制代码

specified（指定实例模式）启动模式

每个UIAbility实例可以设置Key指示。启动UIAbility时，需要订定key，存在key类似实例直接被拉起，不存在则创建新实例
场景: 用户打开文档应用，从文档应用中打开一个文档内容，回到文档应用，继续打开同一个文档，希望打开的还是同一个文档内容；以及在文档应用中新建一个新的文档，每次新建文档，希望打开的都是一个新的空缺文档内容。

• 第一步:创建新的ability，修改module.json5配置文件
  1.1 在ets文件加载创建新的ability，名字为testAbility
  
  
  
  ets多出testAbility文件夹和文件(后续需用用到testAbility文件进行修改)
  
  
  
  1.2 创建为后，module.json5文件的module->abilities会多出一个testAbility对象。并修改module.json5配置文件
  
  
  
  

1. {
2.    "module": {
3.      ...
4.      "abilities": [
5.      ...,
6.         {
7.         "name": "testAbility",
8.         "srcEntry": "./ets/testability/testAbility.ts",
9.         "description": "$string:testAbility_desc",
10.         "icon": "$media:icon",
11.         "label": "$string:testAbility_label",
12.         "startWindowIcon": "$media:icon",
13.         "startWindowBackground": "$color:start_window_background",
14.         "launchType": "specified",
15.       }
16.      ]
17.   }
18. }

复制代码

• 第二步:specified启动模式实例代码
  2.1 当前UIAbility调用startAbility方法拉起目标UIAbility
  实例代码：
  

1. @Entry
2. @Component
3. export struct UiAbilityStartMode{
4.   //1.1 获取上下文
5.   private context = getContext(this) as common.UIAbilityContext;
7.   handleStartAbilityTest(id:number) {
8.     //1.2 指定要跳转到的UIAbility的信息
9.     let want:Want = {
10.       deviceId: '', // deviceId为空表示本设备
11.       bundleName: 'com.example.myapplication',
12.       abilityName: 'testAbility',//ability的名称  去项目module.json5文件里的module.abilities.name
13.       moduleName: 'entry', // 模块名 去项目module.json5文件里的module.name
14.       parameters: { //参数
15.         instanceKey: "id_"+id,//UIAbility实例的key
16.       },
17.     }
18.     //1.3 尝试拉起目标UIAbility实例
19.     this.context.startAbility(want);
20.   }
22.   @State num:number[]=[1,2]
23.   @State curNum:number=1
24.   build(){
25.     Column(){
26.       TitleBar({
27.         titleBarAttribute:{
28.           title:"UIAbility启动模式",
29.           backShow:true,
30.           backCallback:()=>{
31.             router.back()
32.           }
33.         },
34.       }){}
35.       Column(){
36.         Column(){
37.           Text("specified启动模式").fontSize(26).margin({bottom:10})
38.           Button("添加文件").onClick(()=>{
39.             let numData = this.curNum++
40.             this.num.push(numData)
41.             this.handleStartAbilityTest(numData)
42.           })
43.           Column(){
44.             ForEach(this.num,(item,index) => {
45.               Row(){
46.                 Row(){
47.                   Image($r("app.media.csdn")).width(26).margin({right:10})
48.                   Text("文档-"+item).fontColor(Color.White)
49.                 }
50.                 Text("查看文档").fontColor(Color.White)
51.               }.borderRadius(10).margin({bottom:10}).padding(10)
52.               .backgroundColor("#409eff").width("90%").justifyContent(FlexAlign.SpaceBetween)
53.               .onClick(()=>{
54.                 this.handleStartAbilityTest(item)
55.               })
56.             })
57.           }.margin({top:20})
58.         }
60.       }.justifyContent(FlexAlign.Center)
61.       .height("100%")
62.     }
64.   }
65. }

复制代码

运行效果：

文档页面页面代码如下:

1. //文档页面
2. @Entry
3. @Component
4. export struct DocPage{
5.   //1.1 获取上下文
6.   private context = getContext(this) as common.UIAbilityContext;
8.   handleStartAbilityTest() {
9.     //1.2 指定要跳转到的UIAbility的信息
10.     let want:Want = {
11.       deviceId: '', // deviceId为空表示本设备
12.       bundleName: 'com.example.myapplication',
13.       abilityName: 'EntryAbility',//ability的名称  去项目module.json5文件里的module.abilities.name
14.       moduleName: 'entry', // 模块名 去项目module.json5文件里的module.name
15.     }
16.     //1.3 尝试拉起目标UIAbility实例
17.     this.context.startAbility(want);
18.   }
19.   build(){
20.     Column(){
21.       Text("你成功了")
22.       Button("返回").onClick(()=>{
23.         this.handleStartAbilityTest()
24.       })
25.     }.justifyContent(FlexAlign.Center)
26.     .height("100%")
27.   }
28. }

复制代码

• 第三步:为目标UIAbility实例生成唯一key
  3.1 在AbilityStage的生命周期回调中，为目标UIAbility实例生成唯一key。
  在ets下创建abilityStage文件夹和文件，获取UIAbility实例key值
  
  
  
  代码实例
  

1. import AbilityStage from '@ohos.app.ability.AbilityStage';
2. import Want from '@ohos.app.ability.Want';
4. //获取UIAbility实例对应的一个Key值
5. export default class MyAbilityStage extends AbilityStage {
6.   onAcceptWant(want:Want): string {
7.     // 在被调用方的AbilityStage中，针对启动模式为specified的UIAbility返回一个UIAbility实例对应的一个Key值
8.     // 判断当前拉取的ability名称是否为testAbility
9.     if (want.abilityName === 'testAbility') {
10.       // 返回的字符串Key标识为自定义拼接的字符串内容
11.       return `AbilityInstanceKey_${want.parameters.instanceKey}`;
12.     }
14.     return '';
15.   }
16. }

复制代码

还需要在module.json5配置文件编辑srcEntry文件路劲(填写你自己的abilityStage.ets文件路径)，才气获取key值。

4. 第四步:修改testability.ts的加载路径为文档页面

末了重启，点击文档，就能创建差别key的UIAbility实例
   ✨                                                   踩坑不易，还希望各位大佬支持一下                                            \textcolor{gray}{踩坑不易，还希望各位大佬支持一下}                     踩坑不易，还希望各位大佬支持一下