鸿蒙计划分析(一)-AbilityKit

综述

本篇主要是联合官方文档和项目对基础架构进行分析，针对AbilityKit进行现实项目的分析。
Api9以后使用stage模型开辟。
应用步伐包

类型

包括：HAP属于可独立运行的应用Module(一个应用可以包罗多个HAP)，HAR和HSP，属于Libary,HAR是静态Library(资源拷贝)，HSP是共享Library(共享资源)。
HAP
HAP是Ability类型的Module， 实现应用的功能和特性。
每一个Ability类型的Module编译后，会天生一个以.hap为后缀的文件。
HAP包可以独立安装和运行，是应用安装的根本单位，一个应用中可以包罗一个或多个HAP包。
细分为2种类型:

• entry类型的Module：应用的主模块，包罗应用的入口界面、入口图标和主功能特性，编译后天生entry类型的HAP。每一个应用分发到同一类型的装备上的应用步伐包，只能包罗唯逐一个entry类型的HAP。
  
• feature类型的Module：应用的动态特性模块，编译后天生feature类型的HAP。一个应用中可以包罗一个或多个feature类型的HAP，也可以不包罗。
  

HAR/HSP
两者都是Library类型的Module ,实当代码和资源的共享。同一个Library类型的Module可以被其他的Module多次引用。分为Static和Shared两种类型，编译后会天生共享包。

• Static Library：静态共享库。编译后会天生一个以.har为后缀的文件，即静态共享包HAR（Harmony Archive）。
  
• Shared Library：动态共享库。编译后会天生一个以.hsp为后缀的文件，即动态共享包HSP（Harmony Shared Package）
  

具体可参考步伐设置相干包的创建，库应用及动态引用
包目次结构

设置文件

包括应用级设置信息、以及Module级设置信息：
AppScope > app.json5：
app.json5设置文件，用于声明应用的全局设置信息，比如应用Bundle名称、应用名称、应用图标、应用版本号等。

具体可以参考app.json5详细设置
entry(Module_name) > src > main > module.json5：module.json5设置文件，用于声明Module根本信息、支持的装备类型、所含的组件信息、运行所需申请的权限等。

具体可参考module.json5详细设置
ArTs源文件

Module_name > src > main > ets：
用于存放Module的ArkTS源码文件（.ets文件）。

资源文件

包括应用级资源文件、以及Module级资源文件，支持图形、多媒体、字符串、布局文件等，详见资源分类与访问。
AppScope > resources ：
用于存放应用需要用到的资源文件。

entry(Module_name) > src > main > resources ：
用于存放该Module需要用到的资源文件。

其他设置文件

用于编译构建，包括构建设置文件、编译构建使命脚本、混淆规则文件、依赖的共享包信息等。
build-profile.json5：
工程级或Module级的构建设置文件，包括应用署名、产品设置等。

hvigorfile.ts：
应用级或Module级的编译构建使命脚本，开辟者可以自界说编译构建工具版本、控制构建行为的设置参数。

obfuscation-rules.txt：
混淆规则文件。混淆开启后，在使用Release模式进行编译时，会对代码进行编译、混淆及压缩处理，保护代码资产。
oh-package.json5：
用于存放依赖库的信息，包括所依赖的三方库和共享包

应用包的开辟

具体可参考https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/application-package-dev-V5
包括各种包的创建方式及动态加载和延迟加载
AbilityKit

这个是Stage开辟模式的最基础模型
应用组件设置

UIAbility划分原则与发起：

• UIAbility组件是体系调度的根本单位，为应用提供绘制界面的窗口。一个应用可以包罗一个或多个UIAbility组件。比方，在支付应用中，可以将入口功能和收付款功能分别设置为独立的UIAbility。
  
• 每一个UIAbility组件实例都会在最近使命列表中显示一个对应的使命。对于开辟者而言，可以根据具体场景选择单个照旧多个UIAbility，划分发起如下：假如开辟者希望在使命视图中看到一个使命，则发起使用一个UIAbility，多个页面的方式。假如开辟者希望在使命视图中看到多个使命，或者需要同时开启多个窗口，则发起使用多个UIAbility开辟差别的模块功能。
  

module.json5声明相干设置

UIAbility组件

声明设置

UIAbility对应的是 module.json5的abilities级别的设置

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

复制代码

生命周期

1. import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
3. export default class EntryAbility extends UIAbility {
4.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
5.     // 页面初始化
6.   }
7.   // ...
8. }

复制代码

由于UIAbility持有windowStage因而windowStage的状态变革会回调UIAbility

1. import { UIAbility } from '@kit.AbilityKit';
2. import { window } from '@kit.ArkUI';
3. import { hilog } from '@kit.PerformanceAnalysisKit';
5. const TAG: string = '[EntryAbility]';
6. const DOMAIN_NUMBER: number = 0xFF00;
8. export default class EntryAbility extends UIAbility {
9.   // ...
10.   onWindowStageCreate(windowStage: window.WindowStage): void {
11.     // 设置WindowStage的事件订阅（获焦/失焦、可见/不可见）
12.     try {
13.       windowStage.on('windowStageEvent', (data) => {
14.         let stageEventType: window.WindowStageEventType = data;
15.         switch (stageEventType) {
16.           case window.WindowStageEventType.SHOWN: // 切到前台
17.             hilog.info(DOMAIN_NUMBER, TAG, 'windowStage foreground.');
18.             break;
19.           case window.WindowStageEventType.ACTIVE: // 获焦状态
20.             hilog.info(DOMAIN_NUMBER, TAG, 'windowStage active.');
21.             break;
22.           case window.WindowStageEventType.INACTIVE: // 失焦状态
23.             hilog.info(DOMAIN_NUMBER, TAG, 'windowStage inactive.');
24.             break;
25.           case window.WindowStageEventType.HIDDEN: // 切到后台
26.             hilog.info(DOMAIN_NUMBER, TAG, 'windowStage background.');
27.             break;
28.           default:
29.             break;
30.         }
31.       });
32.     } catch (exception) {
33.       hilog.error(DOMAIN_NUMBER, TAG, 'Failed to enable the listener for window stage event changes. Cause:' + JSON.stringify(exception));
34.     }
35.     hilog.info(DOMAIN_NUMBER, TAG, '%{public}s', 'Ability onWindowStageCreate');
36.     // 设置UI加载
37.     windowStage.loadContent('pages/Index', (err, data) => {
38.       // ...
39.     });
40.   }
41. }

复制代码

Destroy状态在UIAbility实例销毁时触发。可以在onDestroy()回调中进行体系资源的释放、数据的保存等操作。
比方调用**terminateSelf()**方法停止当前UIAbility实例，从而完成UIAbility实例的销毁；或者用户使用最近使命列表关闭该UIAbility实例，完成UIAbility的销毁
UIAbility启动模式

singleton（单实例模式）
multiton（多实例模式）
specified（指定实例模式）
设置

模式设置通过module.json5实现

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

复制代码

singleton

单实例模式，startAbility()启动。
再次调用startAbility()方法启动该UIAbility实例。由于启动的照旧原来的UIAbility实例，并未重新创建一个新的UIAbility实例，此时只会进入该UIAbility的onNewWant()回调，不会进入其onCreate()和onWindowStageCreate()生命周期回调
multiton

多实例模式，每次通过startAbility()启动会天生一个新的实例
每次启动都会进入onCreate()和onWindowStageCreate()
Specified

指定模式，
创建UIAbility实例之前，开辟者可以为该实例指定一个唯一的字符串Key，这样在调用startAbility()方法时，调用方就可以根据指定的Key来辨认响应请求的UIAbility实例。在EntryAbility中，调用startAbility()方法时，可以在want参数中增长一个自界说参数，比方instanceKey，以此来区分差别的UIAbility实例
在SpecifiedAbility启动之前，会先进入对应的AbilityStage的onAcceptWant()生命周期回调中，以获取该UIAbility实例的Key值。然后体系会主动匹配，假如存在与该UIAbility实例匹配的Key，则会启动与之绑定的UIAbility实例，并进入该UIAbility实例的onNewWant()回调函数；否则会创建一个新的UIAbility实例，并进入该UIAbility实例的onCreate()回调函数和onWindowStageCreate()回调函数

1. import { AbilityStage, Want } from '@kit.AbilityKit';
3. export default class MyAbilityStage extends AbilityStage {
4.    onAcceptWant(want: Want): string {
5.      // 在被调用方的AbilityStage中，针对启动模式为specified的UIAbility返回一个UIAbility实例对应的一个Key值
6.      // 当前示例指的是module1 Module的SpecifiedAbility
7.      if (want.abilityName === 'SpecifiedFirstAbility' || want.abilityName === 'SpecifiedSecondAbility') {
8.        // 返回的字符串Key标识为自定义拼接的字符串内容
9.        if (want.parameters) {
10.          return `SpecifiedAbilityInstance_${want.parameters.instanceKey}`;
11.        }
12.      }
13.      // ...
14.      return 'MyAbilityStage';
15.    }
16. }

复制代码

UIAbility的用法

指定启动页面

1. onWindowStageCreate(windowStage: window.WindowStage) {
2.     StatusBarManager.immerseFullScreenAsync(windowStage)
3.     // Main window is created, set main page for this ability
4.     hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
6.     windowStage.loadContent('pages/Index', (err, data) => {
7.       if (err.code) {
8.         hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
9.         return;
10.       }
11.       hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
12.     });

复制代码

可以参考如下例子实现启动闪屏，以及新手教程等逻辑
启动闪屏
UIAbility与UI的数据同步

事故通知机制

eventHub实现UIAbility内部通知机制,两种方式实现监听事故的处理

1. export default class EntryAbility extends UIAbility {
2.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
3.     // 获取eventHub
4.     let eventhub = this.context.eventHub;
5.     // 执行订阅操作
6.     eventhub.on('event1', this.eventFunc);
7. //.....
8. eventFunc(argOne: Context, argTwo: Context): void {
9.     hilog.info(DOMAIN_NUMBER, TAG, '1. ' + `${argOne}, ${argTwo}`);
10.     return;
11.   }

复制代码

1. eventhub.on('event1', (data: string) => {
2.       // 触发事件，完成相应的业务操作
3.     });

复制代码

通过emit实现事故的发布

1.     // 不带参数触发自定义“event1”事件
2.     this.context.eventHub.emit('event1');
3.     // 带1个参数触发自定义“event1”事件
4.     this.context.eventHub.emit('event1', 1);
5.     // 带2个参数触发自定义“event1”事件
6.     this.context.eventHub.emit('event1', 2, 'test');
7.     // 开发者可以根据实际的业务场景设计事件传递的参数

复制代码

使用eventHub.off取消事故监听

1. import { UIAbility } from '@kit.AbilityKit';
3. export default class EntryAbility extends UIAbility {
4.   // ...
5.   onDestroy(): void {
6.     this.context.eventHub.off('event1');
7.   }
8. }

复制代码

UIAbility组件间的相互调度

启动应用内的UIAbility

调用方调用startAbility()，通过其中want来实现目标调用

1. private context = getContext(this) as common.UIAbilityContext;
2. let wantInfo: Want = {
3.               deviceId: '', // deviceId为空表示本设备
4.               bundleName: 'com.samples.stagemodelabilitydevelop',
5.               moduleName: 'entry', // moduleName非必选
6.               abilityName: 'FuncAbilityA',
7.               parameters: {
8.                 // 自定义信息
9.                 info: '来自EntryAbility Page_UIAbilityComponentsInteractive页面'
10.               },
11.             };
12. this.context.startAbility(wantInfo).then(() => {
13.               hilog.info(DOMAIN_NUMBER, TAG, 'startAbility success.');
14.             }).catch((error: BusinessError) => {
15.               hilog.error(DOMAIN_NUMBER, TAG, 'startAbility failed.');
16.             });

复制代码

被调用方根据在UIAbility是否已启动，在onCreate或者onNewWant中实现相应want的处理，和参数吸收

1. import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
3. export default class FuncAbilityA extends UIAbility {
4.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
5.     // 接收调用方UIAbility传过来的参数
6.     let funcAbilityWant = want;
7.     let info = funcAbilityWant?.parameters?.info;
8.   }
9.   //...
10. }

复制代码

被调用方通过terminateSelf()来实现本方调用的竣事

1. context.terminateSelf((err) => {
2.             if (err.code) {
3.               hilog.error(DOMAIN_NUMBER, TAG, `Failed to terminate self. Code is ${err.code}, message is ${err.message}`);
4.               return;
5.             }

复制代码

启动应用内的UIAbility并得到效果

通过startAbilityForResult().then实现效果的吸收和处理

1. let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext
2.             const RESULT_CODE: number = 1001;
3.             let want: Want = {
4.               deviceId: '', // deviceId为空表示本设备
5.               bundleName: 'com.samples.stagemodelabilitydevelop',
6.               moduleName: 'entry', // moduleName非必选
7.               abilityName: 'FuncAbilityA',
8.               parameters: {
9.                 // 自定义信息
10.                 info: '来自EntryAbility UIAbilityComponentsInteractive页面'
11.               }
12.             };
13.             context.startAbilityForResult(want).then((data) => {
14.               if (data?.resultCode === RESULT_CODE) {
15.                 // 解析被调用方UIAbility返回的信息
16.                 let info = data.want?.parameters?.info;
17.                 hilog.info(DOMAIN_NUMBER, TAG, JSON.stringify(info) ?? '');
18.                 if (info !== null) {
19.                   promptAction.showToast({
20.                     message: JSON.stringify(info)
21.                   });
22.                 }
23.               }
24.               hilog.info(DOMAIN_NUMBER, TAG, JSON.stringify(data.resultCode) ?? '');
25.             }).catch((err: BusinessError) => {
26.               hilog.error(DOMAIN_NUMBER, TAG, `Failed to start ability for result. Code is ${err.code}, message is ${err.message}`);
27.             });

复制代码

被调用方通过terminateSelfWithResult()实现有关调用效果回调

1. let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext
2.             const RESULT_CODE: number = 1001;
3.             let abilityResult: common.AbilityResult = {
4.               resultCode: RESULT_CODE,
5.               want: {
6.                 bundleName: 'com.samples.stagemodelabilitydevelop',
7.                 moduleName: 'entry', // moduleName非必选
8.                 abilityName: 'FuncAbilityB',
9.                 parameters: {
10.                   info: '来自FuncAbility Index页面'
11.                 },
12.               },
13.             };
14.             context.terminateSelfWithResult(abilityResult, (err) => {
15.               if (err.code) {
16.                 hilog.error(DOMAIN_NUMBER, TAG, `Failed to terminate self with result. Code is ${err.code}, message is ${err.message}`);
17.                 return;
18.               }
19.             });

复制代码

启动UIAbility内的指定页面

区分被调用方冷启动照旧热启动
冷启动
\通过onCreate的want数据吸收，在onWindowStageCreate过程拉起相应的页面

1. import { AbilityConstant, Want, UIAbility } from '@kit.AbilityKit';
2. import { hilog } from '@kit.PerformanceAnalysisKit';
3. import { window, UIContext } from '@kit.ArkUI';
5. const DOMAIN_NUMBER: number = 0xFF00;
6. const TAG: string = '[EntryAbility]';
8. export default class EntryAbility extends UIAbility {
9.   funcAbilityWant: Want | undefined = undefined;
10.   uiContext: UIContext | undefined = undefined;
12.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
13.     // 接收调用方UIAbility传过来的参数
14.     this.funcAbilityWant = want;
15.   }
17.   onWindowStageCreate(windowStage: window.WindowStage): void {
18.     // Main window is created, set main page for this ability
19.     hilog.info(DOMAIN_NUMBER, TAG, '%{public}s', 'Ability onWindowStageCreate');
20.     // Main window is created, set main page for this ability
21.     let url = 'pages/Index';
22.     if (this.funcAbilityWant?.parameters?.router && this.funcAbilityWant.parameters.router === 'funcA') {
23.       url = 'pages/Page_ColdStartUp';
24.     }
25.     windowStage.loadContent(url, (err, data) => {
26.       // ...
27.     });
28.   }
29. }

复制代码

热启动
可以直接在onNewWant中跳转相应页面

1. import { AbilityConstant, Want, UIAbility } from '@kit.AbilityKit';
2. import { hilog } from '@kit.PerformanceAnalysisKit';
3. import type { Router, UIContext } from '@kit.ArkUI';
4. import type { BusinessError } from '@kit.BasicServicesKit';
6. const DOMAIN_NUMBER: number = 0xFF00;
7. const TAG: string = '[EntryAbility]';
9. export default class EntryAbility extends UIAbility {
10.   funcAbilityWant: Want | undefined = undefined;
11.   uiContext: UIContext | undefined = undefined;
12.   // ...
13.   onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
14.     if (want?.parameters?.router && want.parameters.router === 'funcA') {
15.       let funcAUrl = 'pages/Page_HotStartUp';
16.       if (this.uiContext) {
17.         let router: Router = this.uiContext.getRouter();
18.         router.pushUrl({
19.           url: funcAUrl
20.         }).catch((err: BusinessError) => {
21.           hilog.error(DOMAIN_NUMBER, TAG, `Failed to push url. Code is ${err.code}, message is ${err.message}`);
22.         });
23.       }
24.     }
25.   }
26. }

复制代码

ExtensionAbility

体系ExtensionAbility

FormExtensionAbility FORM类型的ExtensionAbility组件，用于提供服务卡片的相干能力。
WorkSchedulerExtensionAbility, WORK_SCHEDULER类型的ExtensionAbility组件，用于提供延迟使命的相干能力。
InputMethodExtensionAbility,INPUT_METHOD类型ExtensionAbility组件，用于实现输入法应用的开辟。
BackupExtensionAbility,BACKUP类型的ExtensionAbility组件，用于提供备份及规复应用数据的能力。
DriverExtensionAbility,DRIVER类型的ExtensionAbility组件，用于提供驱动相干扩展框架。
EmbeddedUIExtensionAbility,EMBEDDED_UI类型的ExtensionAbility组件，用于提供跨历程界面嵌入的能力。
ShareExtensionAbilitymSHARE类型的ExtensionAbility组件，用于提供分享模板服务扩展的能力。
访问体系ExtensionAbility

在鸿蒙体系上自界说输入法
ExtensionAbility开辟

EmbeddedUIExtensionAbility和调用方使用的EmbeddedComponenty共同使用，开辟者可以在UIAbility的页面中通过EmbeddedComponent嵌入本应用的EmbeddedUIExtensionAbility提供的UI。EmbeddedUIExtensionAbility会在独立于UIAbility的历程中运行，完成其页面的布局和渲染。通常用于有历程隔离诉求的模块化开辟场景。

1. import { EmbeddedUIExtensionAbility, UIExtensionContentSession, Want } from '@kit.AbilityKit';
3. const TAG: string = '[ExampleEmbeddedAbility]'
5. export default class ExampleEmbeddedAbility extends EmbeddedUIExtensionAbility {
6.   onCreate() {
7.     console.log(TAG, `onCreate`);
8.   }
10.   onForeground() {
11.     console.log(TAG, `onForeground`);
12.   }
14.   onBackground() {
15.     console.log(TAG, `onBackground`);
16.   }
18.   onDestroy() {
19.     console.log(TAG, `onDestroy`);
20.   }
22.   onSessionCreate(want: Want, session: UIExtensionContentSession) {
23.     console.log(TAG, `onSessionCreate, want: ${JSON.stringify(want)}`);
24.     let param: Record<string, UIExtensionContentSession> = {
25.       'session': session
26.     };
27.     let storage: LocalStorage = new LocalStorage(param);
28.     session.loadContent('pages/extension', storage);
29.   }
31.   onSessionDestroy(session: UIExtensionContentSession) {
32.     console.log(TAG, `onSessionDestroy`);
33.   }
34. }

复制代码

ExtensionUIAbility相干设置

1. {
2.   "module": {
3.     "extensionAbilities": [
4.       {
5.         "name": "EmbeddedUIExtAbility",
6.         "icon": "$media:icon",
7.         "description": "EmbeddedUIExtAbility",
8.         "type": "embeddedUI",
9.         "srcEntry": "./ets/EmbeddedUIExtAbility/EmbeddedUIExtAbility.ts"
10.       },
11.     ]
12.   }
13. }

复制代码

调用方使用embededComponent

1. import { Want } from '@kit.AbilityKit';
2. import { BusinessError } from '@kit.BasicServicesKit';
4. @Entry
5. @Component
6. struct Index {
7.   @State message: string = 'Message: '
8.   private want: Want = {
9.     bundleName: "com.example.embeddeddemo",
10.     abilityName: "EmbeddedUIExtAbility",
11.     parameters: {
12.       'ohos.extension.processMode.hostInstance': 'true'
13.     }
14.   }
16.   build() {
17.     Row() {
18.       Column() {
19.         Text(this.message).fontSize(30)
20.         EmbeddedComponent(this.want, EmbeddedType.EMBEDDED_UI_EXTENSION)
21.           .width('100%')
22.           .height('90%')
23.           .onTerminated((info: TerminationInfo) => {
24.             this.message = 'Terminarion: code = ' + info.code + ', want = ' + JSON.stringify(info.want);
25.           })
26.           .onError((error: BusinessError) => {
27.             this.message = 'Error: code = ' + error.code;
28.           })
29.       }
30.       .width('100%')
31.     }
32.     .height('100%')
33.   }
34. }

复制代码

AbilityStage

module级的组件，拥有onCreate()生命周期回调和onAcceptWant()、onConfigurationUpdated()、onMemoryLevel()事故回调。

1. import { AbilityStage, Want } from '@kit.AbilityKit';
3. export default class MyAbilityStage extends AbilityStage {
4.   onCreate(): void {
5.     // 应用的HAP在首次加载的时，为该Module初始化操作
6.   }
8.   onAcceptWant(want: Want): string {
9.     // 仅specified模式下触发
10.     return 'MyAbilityStage';
11.   }
12. }

复制代码

module.json5的设置,moudule级组件界说在module对应分区

1. {
2.   "module": {
3.     "name": "entry",
4.     "type": "entry",
5.     "srcEntry": "./ets/myabilitystage/MyAbilityStage.ts",
6.     ...
7.   }
8. }

复制代码

应用上下文Context

类型

UIAbilityContext
每个UIAbility中都包罗了一个Context属性，提供操作应用组件、获取应用组件的设置信息等能力

1. import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
3. export default class EntryAbility extends UIAbility {
4.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
5.     let uiAbilityContext = this.context;
6.     //...
7.   }
8. }

复制代码

ExtensionContext
以ServiceExtensionContext为例，表现后台服务的上下文环境，继续自ExtensionContext，提供后台服务相干的接口能力

1. import { ServiceExtensionAbility, Want } from '@kit.AbilityKit';
3. export default class ServiceExtAbility extends ServiceExtensionAbility {
4.   onCreate(want: Want) {
5.     let serviceExtensionContext = this.context;
6.     //...
7.   }
8. }

复制代码

AbilityStageContext
Module级别的Context，和基类Context相比，额外提供HapModuleInfo、Configuration等信息。

1. import { AbilityStage } from '@kit.AbilityKit';
3. export default class MyAbilityStage extends AbilityStage {
4.   onCreate(): void {
5.     let abilityStageContext = this.context;
6.     //...
7.   }
8. }

复制代码

ApplicationStageContext
应用级别的Context。ApplicationContext在基类Context的基础上提供了订阅应用内应用组件的生命周期的变革、订阅体系内存变革和订阅应用内体系环境的变革的能力，在UIAbility、ExtensionAbility、AbilityStage中均可以获取

1. import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
3. export default class EntryAbility extends UIAbility {
4.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
5.     let applicationContext = this.context.getApplicationContext();
6.     //...
7.   }
8. }

复制代码

获取文件路径

基类Context提供了获取应用文件路径的能力，ApplicationContext、AbilityStageContext、UIAbilityContext和ExtensionContext均继续该能力

1. import { common } from '@kit.AbilityKit';
3. import { hilog } from '@kit.PerformanceAnalysisKit';
4. import { promptAction } from '@kit.ArkUI';
6. const TAG: string = '[Page_Context]';
7. const DOMAIN_NUMBER: number = 0xFF00;
9. @Entry
10. @Component
11. struct Page_Context {
12.   private context = getContext(this) as common.UIAbilityContext;
14.   build() {
15.     Column() {
16.       //...
17.       List({ initialIndex: 0 }) {
18.         ListItem() {
19.           Row() {
20.             //...
21.           }
22.           .onClick(() => {
23.             let applicationContext = this.context.getApplicationContext();
24.             let cacheDir = applicationContext.cacheDir;
25.             let tempDir = applicationContext.tempDir;
26.             let filesDir = applicationContext.filesDir;
27.             let databaseDir = applicationContext.databaseDir;
28.             let bundleCodeDir = applicationContext.bundleCodeDir;
29.             let distributedFilesDir = applicationContext.distributedFilesDir;
30.             let preferencesDir = applicationContext.preferencesDir;
31.             let cloudFileDir = applicationContext.cloudFileDir;
32.             // 获取应用文件路径
33.             let filePath = tempDir + 'test.txt';
34.             hilog.info(DOMAIN_NUMBER, TAG, `filePath: ${filePath}`);
35.             if (filePath !== null) {
36.               promptAction.showToast({
37.                 message: filePath
38.               });
39.             }
40.           })
41.         }
42.         //...
43.       }
44.       //...
45.     }
46.     //...
47.   }
48. }

复制代码

获取和修改加密分区

在现实应用中，开辟者需要根据差别场景的需求选择符合的加密分区，从而保护应用数据的安全。通过公道使用差别级别的加密分区，可以有效提高应用数据的安全性

1. import { UIAbility, contextConstant, AbilityConstant, Want } from '@kit.AbilityKit';
3. export default class EntryAbility extends UIAbility {
4.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
5.     // 存储普通信息前，切换到EL1设备级加密
6.     this.context.area = contextConstant.AreaMode.EL1; // 切换area
7.     // 存储普通信息
9.     // 存储敏感信息前，切换到EL2用户级加密
10.     this.context.area = contextConstant.AreaMode.EL2; // 切换area
11.     // 存储敏感信息
13.     // 存储敏感信息前，切换到EL3用户级加密
14.     this.context.area = contextConstant.AreaMode.EL3; // 切换area
15.     // 存储敏感信息
17.     // 存储敏感信息前，切换到EL4用户级加密
18.     this.context.area = contextConstant.AreaMode.EL4; // 切换area
19.     // 存储敏感信息
20.   }
21. }

复制代码

获取本应用中其他Module的Context

调用createModuleContext(moduleName:string)方法，获取本应用中其他Module的Context。获取到其他Module的Context之后，即可获取到相应Module的资源信息

1. import { common } from '@kit.AbilityKit';
3. import { promptAction } from '@kit.ArkUI';
5. let storageEventCall = new LocalStorage();
7. @Entry(storageEventCall)
8. @Component
9. struct Page_Context {
10.   private context = getContext(this) as common.UIAbilityContext;
12.   build() {
13.     Column() {
14.       //...
15.       List({ initialIndex: 0 }) {
16.         ListItem() {
17.           Row() {
18.             //...
19.           }
20.           .onClick(() => {
21.             let moduleName2: string = 'entry';
22.             let moduleContext: Context = this.context.createModuleContext(moduleName2);
23.             if (moduleContext !== null) {
24.               promptAction.showToast({
25.                 message: ('成功获取Context')
26.               });
27.             }
28.           })
29.         }
30.         //...
31.       }
32.       //...
33.     }
34.     //...
35.   }
36. }

复制代码

订阅历程内UIAbility生命周期变革

通过ApplicationContext提供的能力，可以订阅历程内UIAbility生命周期变革。当历程内的UIAbility生命周期变革时，如创建、可见/不可见、获焦/失焦、销毁等，会触发相应的回调函数。每次注册回调函数时，都会返回一个监听生命周期的ID，此ID会自增+1。当超过监听上限数量2^63-1时，会返回-1。
核心在this.lifecycleId = applicationContext.on(‘abilityLifecycle’, abilityLifecycleCallback)

1. import { AbilityConstant, AbilityLifecycleCallback, UIAbility, Want } from '@kit.AbilityKit';
2. import { hilog } from '@kit.PerformanceAnalysisKit';
3. import { window } from '@kit.ArkUI';
4. import  { BusinessError } from '@kit.BasicServicesKit';
6. const TAG: string = '[LifecycleAbility]';
7. const DOMAIN_NUMBER: number = 0xFF00;
9. export default class LifecycleAbility extends UIAbility {
10.   // 定义生命周期ID
11.   lifecycleId: number = -1;
13.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
14.     // 定义生命周期回调对象
15.     let abilityLifecycleCallback: AbilityLifecycleCallback = {
16.       // 当UIAbility创建时被调用
17.       onAbilityCreate(uiAbility) {
18.         hilog.info(DOMAIN_NUMBER, TAG, `onAbilityCreate uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
19.       },
20.       // 当窗口创建时被调用
21.       onWindowStageCreate(uiAbility, windowStage: window.WindowStage) {
22.         hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageCreate uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
23.         hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageCreate windowStage: ${JSON.stringify(windowStage)}`);
24.       },
25.       // 当窗口处于活动状态时被调用
26.       onWindowStageActive(uiAbility, windowStage: window.WindowStage) {
27.         hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageActive uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
28.         hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageActive windowStage: ${JSON.stringify(windowStage)}`);
29.       },
30.       // 当窗口处于非活动状态时被调用
31.       onWindowStageInactive(uiAbility, windowStage: window.WindowStage) {
32.         hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageInactive uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
33.         hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageInactive windowStage: ${JSON.stringify(windowStage)}`);
34.       },
35.       // 当窗口被销毁时被调用
36.       onWindowStageDestroy(uiAbility, windowStage: window.WindowStage) {
37.         hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageDestroy uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
38.         hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageDestroy windowStage: ${JSON.stringify(windowStage)}`);
39.       },
40.       // 当UIAbility被销毁时被调用
41.       onAbilityDestroy(uiAbility) {
42.         hilog.info(DOMAIN_NUMBER, TAG, `onAbilityDestroy uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
43.       },
44.       // 当UIAbility从后台转到前台时触发回调
45.       onAbilityForeground(uiAbility) {
46.         hilog.info(DOMAIN_NUMBER, TAG, `onAbilityForeground uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
47.       },
48.       // 当UIAbility从前台转到后台时触发回调
49.       onAbilityBackground(uiAbility) {
50.         hilog.info(DOMAIN_NUMBER, TAG, `onAbilityBackground uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
51.       },
52.       // 当UIAbility迁移时被调用
53.       onAbilityContinue(uiAbility) {
54.         hilog.info(DOMAIN_NUMBER, TAG, `onAbilityContinue uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
55.       }
56.     };
57.     // 获取应用上下文
58.     let applicationContext = this.context.getApplicationContext();
59.     try {
60.       // 注册应用内生命周期回调
61.       this.lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback);
62.     } catch (err) {
63.       let code = (err as BusinessError).code;
64.       let message = (err as BusinessError).message;
65.       hilog.error(DOMAIN_NUMBER, TAG, `Failed to register applicationContext. Code is ${code}, message is ${message}`);
66.     }
68.     hilog.info(DOMAIN_NUMBER, TAG, `register callback number: ${this.lifecycleId}`);
69.   }
70.   //...
71.   onDestroy(): void {
72.     // 获取应用上下文
73.     let applicationContext = this.context.getApplicationContext();
74.     try {
75.       // 取消应用内生命周期回调
76.       applicationContext.off('abilityLifecycle', this.lifecycleId);
77.     } catch (err) {
78.       let code = (err as BusinessError).code;
79.       let message = (err as BusinessError).message;
80.       hilog.error(DOMAIN_NUMBER, TAG, `Failed to unregister applicationContext. Code is ${code}, message is ${message}`);
81.     }
82.   }
83. }

复制代码

want信息传递载体

显式与隐式

Want是一种对象，用于在应用组件之间传递信息。
其中，一种常见的使用场景是作为startAbility()方法的参数。比方，当UIAbilityA需要启动UIAbilityB并向UIAbilityB传递一些数据时，可以使用Want作为一个载体，将数据传递给UIAbilityB。

显示want

1. import { Want } from '@kit.AbilityKit';
3. let wantInfo: Want = {
4.   deviceId: '', // deviceId为空表示本设备
5.   bundleName: 'com.example.myapplication',
6.   abilityName: 'FuncAbility',
7. }

复制代码

隐式want

1. import { Want } from '@kit.AbilityKit';
3. let wantInfo: Want = {
4.   // uncomment line below if wish to implicitly query only in the specific bundle.
5.   // bundleName: 'com.example.myapplication',
6.   action: 'ohos.want.action.search',
7.   // entities can be omitted
8.   entities: [ 'entity.system.browsable' ],
9.   uri: 'https://www.test.com:8080/query/student',
10.   type: 'text/plain',
11. };

复制代码

want匹配原则

调用方传入的want参数，表明调用方需要执行的操作，并提供相干数据以及其他应用类型限制。
待匹配应用组件的skills设置，声明其具备的能力（module.json5设置文件中的skills标签参数）。
具体匹配参见官方文档.
应用启动使命AppStartup

应用启动时通常需要执行一系列初始化启动使命，假如将启动使命都放在应用主模块（即entry类型的Module）的UIAbility组件的onCreate生命周期中，那么只能在主线程中依次执行，不光影响应用的启动速度，而且当启动使命过多时，使命之间复杂的依赖关系还会使得代码难以维护。
AppStartup提供了一种简朴高效的应用启动方式，可以支持使命的异步启动，加快应用启动速度。同时，通过在一个设置文件中同一设置多个启动使命的执行顺序以及依赖关系，让执行启动使命的代码变得更加简洁清楚、容易维护。
启动框架支持以主动模式或手动模式执行启动使命，默认采用主动模式。在AbilityStage组件容器完成创建后开始加载开辟者设置的启动使命，并执行主动模式的启动使命。开辟者也可以在UIAbility创建完后调用startupManager.run方法，执行手动模式的启动使命

主要使用resources/base/profile下的profile设置相应的启动使命

1. {
2.   "startupTasks": [
3.     {
4.       "name": "StartupTask_001",
5.       "srcEntry": "./ets/startup/StartupTask_001.ets",
6.       "dependencies": [
7.         "StartupTask_002",
8.         "StartupTask_003"
9.       ],
10.       "runOnThread": "taskPool",
11.       "waitOnMainThread": false
12.     },
13.     {
14.       "name": "StartupTask_002",
15.       "srcEntry": "./ets/startup/StartupTask_002.ets",
16.       "dependencies": [
17.         "StartupTask_004"
18.       ],
19.       "runOnThread": "taskPool",
20.       "waitOnMainThread": false
21.     },
22.     {
23.       "name": "StartupTask_003",
24.       "srcEntry": "./ets/startup/StartupTask_003.ets",
25.       "dependencies": [
26.         "StartupTask_004"
27.       ],
28.       "runOnThread": "taskPool",
29.       "waitOnMainThread": false
30.     },
31.     {
32.       "name": "StartupTask_004",
33.       "srcEntry": "./ets/startup/StartupTask_004.ets",
34.       "runOnThread": "taskPool",
35.       "waitOnMainThread": false
36.     },
37.     {
38.       "name": "StartupTask_005",
39.       "srcEntry": "./ets/startup/StartupTask_005.ets",
40.       "dependencies": [
41.         "StartupTask_006"
42.       ],
43.       "runOnThread": "mainThread",
44.       "waitOnMainThread": true,
45.       "excludeFromAutoStart": true
46.     },
47.     {
48.       "name": "StartupTask_006",
49.       "srcEntry": "./ets/startup/StartupTask_006.ets",
50.       "runOnThread": "mainThread",
51.       "waitOnMainThread": false,
52.       "excludeFromAutoStart": true
53.     }
54.   ],
55.   "configEntry": "./ets/startup/StartupConfig.ets"
56. }

复制代码

在module.json5中设定appStartup标签，指向设定的profile

1. {
2.   "module": {
3.     "name": "entry",
4.     "type": "entry",
5.     // ...
6.     "appStartup": "$profile:startup_config", // 启动框架的配置文件
7.     // ...
8.   }
9. }

复制代码

configEntry用于指定StartupConfigEntry类型的实例实现启动使命的管理和状态监听

1. import { StartupConfig, StartupConfigEntry, StartupListener } from '@kit.AbilityKit';
2. import { hilog } from '@kit.PerformanceAnalysisKit';
3. import { BusinessError } from '@kit.BasicServicesKit';
5. export default class MyStartupConfigEntry extends StartupConfigEntry {
6.   onConfig() {
7.     hilog.info(0x0000, 'testTag', `onConfig`);
8.     let onCompletedCallback = (error: BusinessError<void>) => {
9.       hilog.info(0x0000, 'testTag', `onCompletedCallback`);
10.       if (error) {
11.         hilog.info(0x0000, 'testTag', 'onCompletedCallback: %{public}d, message: %{public}s', error.code, error.message);
12.       } else {
13.         hilog.info(0x0000, 'testTag', `onCompletedCallback: success.`);
14.       }
15.     };
16.     let startupListener: StartupListener = {
17.       'onCompleted': onCompletedCallback
18.     };
19.     let config: StartupConfig = {
20.       'timeoutMs': 10000,
21.       'startupListener': startupListener
22.     };
23.     return config;
24.   }
25. }

复制代码

每个使命继续StartupTask，需要独立实现init和onDependencyCompleted

1. import { StartupTask, common } from '@kit.AbilityKit';
2. import { hilog } from '@kit.PerformanceAnalysisKit';
4. @Sendable
5. export default class StartupTask_001 extends StartupTask {
6.   constructor() {
7.     super();
8.   }
10.   async init(context: common.AbilityStageContext) {
11.     hilog.info(0x0000, 'testTag', 'StartupTask_001 init.');
12.     return 'StartupTask_001';
13.   }
15.   onDependencyCompleted(dependence: string, result: Object): void {
16.     hilog.info(0x0000, 'testTag', 'StartupTask_001 onDependencyCompleted, dependence: %{public}s, result: %{public}s',
17.       dependence, JSON.stringify(result));
18.   }
19. }

复制代码

通过startupMgr.run可以实现使命的非主动启动

1. import { AbilityConstant, UIAbility, Want, startupManager } from '@kit.AbilityKit';
2. import { hilog } from '@kit.PerformanceAnalysisKit';
3. import { BusinessError } from '@kit.BasicServicesKit';
5. export default class EntryAbility extends UIAbility {
6.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
7.     hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
8.     let startParams = ['StartupTask_005', 'StartupTask_006'];
9.     try {
10.       startupManager.run(startParams).then(() => {
11.         console.log('StartupTest startupManager run then, startParams = ');
12.       }).catch((error: BusinessError) => {
13.         console.info("StartupTest promise catch error, error = " + JSON.stringify(error));
14.         console.info("StartupTest promise catch error, startParams = "
15.           + JSON.stringify(startParams));
16.       })
17.     } catch (error) {
18.       let errMsg = JSON.stringify(error);
19.       let errCode: number = error.code;
20.       console.log('Startup catch error , errCode= ' + errCode);
21.       console.log('Startup catch error ,error= ' + errMsg);
22.     }
23.   }
25.   // ...
26. }

复制代码

订阅体系

ApplicationContext订阅回调

ApplicationContext提供了注册回调函数以订阅体系环境变量的变革，并且可以通过调用相应的方法来打消该

• ApplicationContext.on(type: ‘environment’, callback: EnvironmentCallback)
  

   EnvironmentCallback.onConfigurationUpdated
EnvironmentCallback.onMemoryLevel
参考ApiReference
需要通过ApplicationContext.off(type: ‘environment’, callbackId: number)方法释放相干资源
  AbilityStage订阅回调

使用AbilityStage.onConfigurationUpdate()回调方法订阅体系环境变量的变革。当体系环境变量发生变革时，会调用该回调方法。在该方法中，通过Configuration对象获取最新的体系环境设置信息

1. import { AbilityStage, Configuration } from '@kit.AbilityKit';
2. import { hilog } from '@kit.PerformanceAnalysisKit';
4. const TAG: string = '[MyAbilityStage]';
5. const DOMAIN_NUMBER: number = 0xFF00;
7. let systemLanguage: string | undefined; // 系统当前语言
9. export default class MyAbilityStage extends AbilityStage {
10.   onCreate(): void {
11.     systemLanguage = this.context.config.language; // Module首次加载时，获取系统当前语言
12.     hilog.info(DOMAIN_NUMBER, TAG, `systemLanguage is ${systemLanguage}`);
13.     //...
14.   }
16.   onConfigurationUpdate(newConfig: Configuration): void {
17.     hilog.info(DOMAIN_NUMBER, TAG, `onConfigurationUpdate, language: ${newConfig.language}`);
18.     hilog.info(DOMAIN_NUMBER, TAG, `onConfigurationUpdated systemLanguage is ${systemLanguage}, newConfig: ${JSON.stringify(newConfig)}`);
20.     if (systemLanguage !== newConfig.language) {
21.       hilog.info(DOMAIN_NUMBER, TAG, `systemLanguage from ${systemLanguage} changed to ${newConfig.language}`);
22.       systemLanguage = newConfig.language; // 将变化之后的系统语言保存，作为下一次变化前的系统语言
23.     }
24.   }
25. }

复制代码

UIAbility订阅回调

UIAbility组件提供了UIAbility.onConfigurationUpdate()回调方法用于订阅体系环境变量的变革。当体系环境变量发生变革时，会调用该回调方法。在该方法中，通过Configuration对象获取最新的体系环境设置信息，而无需重启UIAbility。

1. import { AbilityConstant, Configuration, UIAbility, Want } from '@kit.AbilityKit';
2. import { hilog } from '@kit.PerformanceAnalysisKit';
4. const TAG: string = '[EntryAbility]';
5. const DOMAIN_NUMBER: number = 0xFF00;
7. let systemLanguage: string | undefined; // 系统当前语言
9. export default class EntryAbility extends UIAbility {
10.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
11.     systemLanguage = this.context.config.language; // UIAbility实例首次加载时，获取系统当前语言
12.     hilog.info(DOMAIN_NUMBER, TAG, `systemLanguage is ${systemLanguage}`);
13.   }
15.   onConfigurationUpdate(newConfig: Configuration): void {
16.     hilog.info(DOMAIN_NUMBER, TAG, `onConfigurationUpdated systemLanguage is ${systemLanguage}, newConfig: ${JSON.stringify(newConfig)}`);
18.     if (systemLanguage !== newConfig.language) {
19.       hilog.info(DOMAIN_NUMBER, TAG, `systemLanguage from ${systemLanguage} changed to ${newConfig.language}`);
20.       systemLanguage = newConfig.language; // 将变化之后的系统语言保存，作为下一次变化前的系统语言
21.     }
22.   }
23.   // ...
24. }

复制代码

ExtensionAbility订阅回调

ExtensionAbility组件提供了onConfigurationUpdate()回调方法用于订阅体系环境变量的变革。当体系环境变量发生变革时，会调用该回调方法。在该方法中，通过Configuration对象获取最新的体系环境设置信息。

1. import { FormExtensionAbility } from '@kit.FormKit';
2. import { Configuration } from '@kit.AbilityKit';
3. import { hilog } from '@kit.PerformanceAnalysisKit';
5. const TAG: string = '[EntryAbility]';
6. const DOMAIN_NUMBER: number = 0xFF00;
8. export default class EntryFormAbility extends FormExtensionAbility {
9.   onConfigurationUpdate(config: Configuration) {
10.     hilog.info(DOMAIN_NUMBER, TAG, '[EntryFormAbility] onConfigurationUpdate:' + JSON.stringify(config));
11.   }
12.   // ...
13. }

复制代码

Configuration

参考ApiReference Configuration
应用间跳转

类型

包括指向性跳转和通用意图跳转
指向性跳转
   当前支持指定应用链接（保举）：通过openLink或startAbility接口来指定应用链接，拉起目标应用页面。
  通用意图跳转:
   拉起方应用只申明跳转意图、而不指定具体跳转到哪一个应用，通过调用接口来拉起满足用户意图的垂类应用面板，该面板将展示目标方接入的垂域应用，由用户选择打开指定应用。
常见的通用意图跳转包括导航、分享、文件打开等高频场景，差别意图类型的跳转实现也有多种方式。
导航：支持导航、所在搜索、路线规划
文件打开：打开特定类型的文件
分享：支持文本、图片、视频等内容的跨应用分享
支付：支持实物商品和服务的支付
  跳转URL格式
   scheme://host[:port]/path/
scheme：协议名称。比方http、https等。
host：域名或IP地址。比方域名developer.huawei.com或IP地址127.0.0.1；
port：端标语。比方developer.huawei.com:80背面的80即为端标语。
path：路径，表现域名服务器上的目次或文件路径。比方developer.huawei.com/consumer/中consumer
  应用毗连跳转机制
   目标应用在设置文件中注册自己的URL，并对外提供URL。
拉起方应用在跳转接口中传入目标应用的URL等信息。
体系吸收到URL等相干信息，会寻找对应匹配项，并跳转至目标应用
  支持Deep Linking 和App Linking
指向性跳转

跳转设置

调用方需要在module.json5设置queryparam

1. {
2.   "module": {
3.     //...
4.     "querySchemes": [
5.       "app1Scheme"
6.     ]
7.   }
8. }

复制代码

被调用方需要在module.jso5设置支持的skills/uris

1. {
2.   "module": {
3.     //...
4.     "abilities": [
5.       {
6.         //...
7.         "skills": [
8.           {
9.             "uris": [
10.               {
11.                 "scheme": "app1Scheme",
12.                 "host": "test.example.com",
13.                 "pathStartWith": "home"
14.               }
15.             ]
16.           }
17.         ]
18.       }
19.     ]
20.   }
21. }

复制代码

调用方可以通过canOpenLink来判断可跳转性

1. import { bundleManager } from '@kit.AbilityKit';
2. import { BusinessError } from '@kit.BasicServicesKit';
3. import { hilog } from '@kit.PerformanceAnalysisKit';
4. try {
5.   let link = 'app1Scheme://test.example.com/home';
6.   let canOpen = bundleManager.canOpenLink(link);
7.   hilog.info(0x0000, 'testTag', 'canOpenLink successfully: %{public}s', JSON.stringify(canOpen));
8. } catch (err) {
9.   let message = (err as BusinessError).message;
10.   hilog.error(0x0000, 'testTag', 'canOpenLink failed: %{public}s', message);
11. }

复制代码

DeepLinking

   目标应用需要在module.json5设置文件中声明URL skill。其中，uri字段的scheme的取值支持自界说，可以界说为任意不包罗特殊字符、非ohos开头的字符串。

1. {
2.   "module": {
3.     "abilities": [
4.       {
5.         "name": "EntryAbility",
6.         "srcEntry": "./ets/entryability/EntryAbility.ets",
7.         "icon": "$media:icon",
8.         "label": "$string:EntryAbility_label",
9.         "startWindowIcon": "$media:icon",
10.         "startWindowBackground": "$color:start_window_background",
11.         "skills": [
12.           {
13.             "entities": [
14.               // entities须包含"entity.system.browsable"
15.               "entity.system.browsable"
16.             ],
17.             "actions": [
18.               // actions须包含"ohos.want.action.viewData"
19.               "ohos.want.action.viewData"
20.             ],
21.             "uris": [
22.               {
23.                 // scheme可以自定义
24.                 "scheme": "http",
25.                 // host须配置关联的域名
26.                 "host": "www.example.com",
27.                 // path可选，为了避免匹配到多个应用，建议配置该字段
28.                 "path": "path1"
29.               }
30.             ]
31.           }
32.         ]
33.       }
34.     ]
35.   }
36. }

复制代码

  调用方使用openLink实现调用

1. import { common } from '@kit.AbilityKit';
3. import OpenLinkOptions from '@ohos.app.ability.OpenLinkOptions';
4. import { BusinessError } from '@ohos.base';
5. import hilog from '@ohos.hilog';
7. const TAG: string = '[UIAbilityComponentsOpenLink]';
8. const DOMAIN_NUMBER: number = 0xFF00;
10. @Entry
11. @Component
12. struct Index {
13.   build() {
14.     Button('start link', { type: ButtonType.Capsule, stateEffect: true })
15.       .width('87%')
16.       .height('5%')
17.       .margin({ bottom: '12vp' })
18.       .onClick(() => {
19.         let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
20.         let link: string = "http://www.example.com";
21.         let openLinkOptions: OpenLinkOptions = {
22.           appLinkingOnly: false
23.         };
25.         try {
26.           context.openLink(link, openLinkOptions)
27.             .then(() => {
28.               hilog.info(DOMAIN_NUMBER, TAG, 'open link success.');
29.             }).catch((err: BusinessError) => {
30.               hilog.error(DOMAIN_NUMBER, TAG, `open link failed. Code is ${err.code}, message is ${err.message}`);
31.             })
32.         } catch (paramError) {
33.           hilog.error(DOMAIN_NUMBER, TAG, `Failed to start link. Code is ${paramError.code}, message is ${paramError.message}`);
34.         }
35.       })
36.   }
37. }

复制代码

通用意图跳转

通过startAbilityByType拉起垂类应用

接口startAbilityByType(API 11+) 是UIAbilityContext和UIExtensionContentSession提供的支持基于垂域业务类型拉起垂域面板，调用方通过指定特定的垂域业务类型即可拉起对应的垂域面板，在垂域面板上将展示目标方接入的垂域应用
比方，针对导航的跳转
调用方使用startAbilityByType和AbilityStartCallback

1. import { common } from '@kit.AbilityKit';

复制代码

1. let context = getContext(this) as common.UIAbilityContext;
2. let wantParam: Record<string, Object> = {
3.   'sceneType': 1,
4.   'destinationLatitude': 32.060844,
5.   'destinationLongitude': 118.78315,
6.   'destinationName': 'xx市xx路xx号',
7.   'originName': 'xx市xx公园',
8.   'originLatitude': 31.060844,
9.   'originLongitude': 120.78315,
10.   'vehicleType': 0
11. };
12. let abilityStartCallback: common.AbilityStartCallback = {
13.   onError: (code: number, name: string, message: string) => {
14.     console.log(`code:` + code + `name:` + name + `message:` + message);
15.   }
16. }
18. context.startAbilityByType("navigation", wantParam, abilityStartCallback, (err) => {
19. if (err) {
20.     console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`);
21.   } else {
22.     console.log(`success`);
23.   }
24. });

复制代码

被调用放的应用需要声明相干能力

1. {
2.   "abilities": [
3.       {
4.       "skills": [
5.           {
6.           "uris": [
7.               {
8.               "scheme": "maps", // 这里仅示意，应用需确保这里声明的的uri能被外部正常拉起
9.               "host": "navigation",
10.               "path": "",
11.               "linkFeature": "Navigation" // 声明应用支持导航功能
12.               },
13.               {
14.               "scheme": "maps", // 这里仅示意，应用需确保这里声明的的uri能被外部正常拉起
15.               "host": "routePlan",
16.               "path": "",
17.               "linkFeature": "RoutePlan" // 声明应用支持路线规划功能
18.               },
19.               {
20.               "scheme": "maps", // 这里仅示意，应用需确保这里声明的的uri能被外部正常拉起
21.               "host": "search",
22.               "path": "",
23.               "linkFeature": "PlaceSearch" // 声明应用支持位置搜索功能
24.               }
25.           ]
26.           }
27.       ]
28.       }
29.   ]
30. }

复制代码

在onCreate中吸收参数并实现相干导航关联逻辑

1. UIAbility::onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): voi

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。