【最新鸿蒙应用开发】—

【最新鸿蒙应用开发】——Want信息载体

信息传递载体Want

1、概述

上一章节我们学习了UIAbility组件【最新鸿蒙应用开发】——一篇搞懂什么是UIAbility-CSDN博客
，其中组件间的交互传递信息的媒介就是Want，本章节我们来更加深入学习Want的相关知识。 Want是一种对象，用于在应用组件之间传递信息。

2、类型

显式Want：在启动目标应用组件时，调用方传入的want参数中指定了abilityName和bundleName，称为显式Want。
隐式Want：在启动目标应用组件时，调用方传入的want参数中未指定abilityName，称为隐式Want。

import Want from '@ohos.app.ability.Want';

// 1. 显式Want
let wantInfo: Want = {deviceId: '', // deviceId为空表示本设备bundleName: 'com.example.myapplication',abilityName: 'FuncAbility',
}

// 2. 隐式Want
let wantInfo: Want = {// uncomment line below if wish to implicitly query only in the specific bundle.// bundleName: 'com.example.myapplication',action: 'ohos.want.action.search',// entities can be omittedentities: [ 'entity.system.browsable' ],uri: 'https://www.test.com:8080/query/student',type: 'text/plain',
};

3、匹配规则

调用方传入的want参数中设置的参数如何与目标应用组件声明的配置文件进行匹配，需要时查看参考文档即可。

显式Want与隐式Want匹配规则 (openharmony.cn)

4、使用场景

在调用startAbility()方法时，其入参want中指定了一系列的entities字段（表示目标UIAbility额外的类别信息，如浏览器、视频播放器）和actions字段（表示要执行的通用操作，如查看、分享、应用详情等）等参数信息，
然后由系统去分析want，并帮助找到合适的UIAbility来启动。

使用显式Want启动应用组件

在应用使用场景中，当用户在应用内点击某个按钮时，经常需要拉起指定UIAbility组件来完成某些特定任务。在启动UIAbility时，指定了abilityName和bundleName参数，可以使用显式Want方式启动UIAbility。

针对应用的特定任务，用户需要通过点击应用内的按钮来启动指定的UIAbility组件。在启动UIAbility时，需要提供abilityName和bundleName参数，并使用显式Want方式来启动。

使用隐式Want打开网址

以打开浏览器为例，假设设备上安装了一个或多个浏览器应用。为了使浏览器应用能够正常工作，需要在module.json5配置文件进行配置，具体配置如下：

{"module": {"abilities": [{//入口配置"skills": [{"actions": ["action.system.home"],"entities": ["entity.system.home"]},//浏览器配置{"actions": ["ohos.want.action.viewData"],"entities": ["entity.system.browsable"],"uris": [{"scheme": "https","host": "www.test.com","port": "8080","pathStartWith": "query"},{"scheme": "http"}]}]}]}
}

在调用方UIAbility中，使用隐式Want方式启动浏览器应用。

import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';

let context = getContext(this) as common.UIAbilityContext;
let wantInfo: Want = {// uncomment line below if wish to implicitly query only in the specific bundle.// bundleName: 'com.example.myapplication',action: 'ohos.want.action.viewData',// entities can be omitted.entities: ['entity.system.browsable'],uri: 'https://www.test.com:8080/query/student'
}
context.startAbility(wantInfo).then(() => {// ...
}).catch((err: BusinessError) => {// ...
})

匹配过程分析：

调用方传入的want参数的action不为空，待匹配目标应用组件的skills配置中的actions不为空且包含调用方传入的want参数的action，action匹配成功。
调用方传入的want参数的entities不为空，待匹配目标应用组件的skills配置中的entities不为空且包含调用方传入的want参数的entities，entities匹配成功。
待匹配目标应用组件的skills配置中内uris拼接为https://www.test.com:8080/query*（其中*表示通配符），包含调用方传入的want参数的uri，uri匹配成功。

当存在多个匹配的应用时，系统将弹出应用选择框供用户选择。示意效果如下图所示。