鸿蒙HarmonyOS实战-Stage模型（信息传递载体Want）_want的基本概念、用途和类型let wantInf

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

隐式Want：隐式Want是指不明确指定要操作的组件或服务的Want，而是根据一定的规则和条件来进行匹配。通过隐式Want，可以实现组件之间的解耦和灵活性。隐式Want一般包含一组动作、类别、数据类型等条件，系统会根据这些条件来匹配合适的组件或服务。例如，可以使用隐式Want来处理某个特定类型的数据或根据某个特定的动作执行相应的操作。

let wantInfo = { // 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 omitted entities: [ 'entity.system.browsable' ], uri: 'www.test.com:8080/query/stude…', type: 'text/plain', };

2.显式Want与隐式Want匹配规则

🦋2.1 隐式Want匹配原理详解

系统将调用方传入的want参数（包含action、entities、uri和type属性）与已安装待匹配的应用Ability的skills配置（包含actions、entities、uris和type属性）依次进行匹配。当四个属性匹配均通过，则此应用才会被应用选择器展示给用户进行选择。

☀️2.1.1 want参数的action匹配规则

调用方传入的want参数的action	待匹配Ability的skills配置中的actions	匹配结果
为空	为空	匹配失败
不为空	为空	匹配失败
为空	不为空	匹配成功
不为空	包含调用方传入的action	匹配成功
不为空	不包含调用方传入的action	匹配失败

在这里插入图片描述

☀️2.1.2 want参数的entities匹配规则

want参数的entities	待匹配Ability的skills配置的entities	匹配结果
为空	不为空	成功
为空	为空	成功
不为空	为空	失败
不为空	包含调用方传入的entities	成功
不为空	不完全包含调用方传入的entities	失败

在这里插入图片描述

☀️2.1.3 want参数的uri和type匹配规则

在这里插入图片描述

调用方传入的want参数	待匹配Ability的skills配置中的uris数组	匹配结果
uri为空，type为空	uris为空	匹配成功
uri为空，type为空	uris存在uri的scheme和type都为空的元素	匹配成功
uri为空，type为空	其他情况	匹配失败
uri不为空，type为空	uris为空	匹配失败
uri不为空，type为空	uris存在一条数据uri匹配成功且type为空	匹配成功
uri为空，type不为空	uris为空	匹配失败
uri为空，type不为空	uris存在一条数据uri的scheme为空且type匹配成功	匹配成功
uri不为空，type不为空	uris为空	匹配失败
uri不为空，type不为空	uris存在一条数据uri匹配和type匹配需要均匹配成功	匹配成功
uri不为空，type不为空	其他情况	匹配失败

在这里插入图片描述

☀️2.1.4 uri匹配规则

以下是根据给定匹配规则展示的表格：

s_uri.host	s_uri.path	s_uri.pathStartWith	s_uri.pathRegex	w_uri	匹配结果
				abc://def	成功
					失败
abc://def				abc://def	成功
abc://def				def://abc	失败
	/path			/path	成功
	/path			/path/123	失败
		/pathStart		/pathStart	成功
		/pathStart		/pathStart2	失败
			^/regex$	/regex	成功
			^/regex$	/path/regex	失败
abc://def	/path			abc://def/path	成功
abc://def	/path			abc://def/path/123	失败
		/pathStart		/pathStart2/test	失败
			^/regex$	/path/regex/test	失败

待匹配Ability的skills配置的uris中scheme、host、port、path、pathStartWith和pathRegex属性拼接，如果依次声明了path、pathStartWith和pathRegex属性时，uris将分别拼接为如下三种表达式：

全路径表达式：scheme://host:port/path
前缀表达式：scheme://host:port/pathStartWith
正则表达式：scheme://host:port/pathRegex

☀️2.1.5 type匹配规则

Ability Skills Regex匹配规则	w_type匹配规则	匹配结果
s_type为空	任意	失败
s_type为通配符"/"	任意	成功
s_type为通配符"prefixType/*"	含有"prefixType/"	成功
s_type为通配符"prefixType/*"	不含有"prefixType/"	失败
w_type为通配符"/"	任意	成功
w_type为通配符"prefixType/*"	含有"prefixType/"	成功
w_type为通配符"prefixType/*"	不含有"prefixType/"	失败

3.常见action与entities

🦋3.1 action

表示调用方要执行的通用操作（如查看、分享、应用详情）

Action（动作）	描述
ACTION_HOME	启动应用入口组件的动作，需要和ENTITY_HOME配合使用；系统桌面应用图标就是显式的入口组件，点击也是启动入口组件；入口组件可以配置多个。
ACTION_CHOOSE	选择本地资源数据，例如联系人、相册等；系统一般对不同类型的数据有对应的Picker应用，例如联系人和图库。
ACTION_VIEW_DATA	查看数据，当使用网址uri时，则表示显示该网址对应的内容。
ACTION_VIEW_MULTIPLE_DATA	发送多个数据记录的操作。

🦋3.2 entities

表示目标Ability的类别信息（如浏览器、视频播放器）

类别名称	描述
ENTITY_DEFAULT	默认类别，没有实际意义。
ENTITY_HOME	主屏幕有图标点击入口类别。
ENTITY_BROWSABLE	指示浏览器类别。

4.使用显式Want启动Ability

1、启动方

新建callerAbility
在这里插入图片描述

2、被启动方

同理新建calleeAbility
在这里插入图片描述
3、启动方UI

import common from '@ohos.app.ability.common'; @Entry @Component struct Index { @State message: string = 'callerAbility'

build() { Row() { Column() { Text('hello') .fontSize(50) .fontWeight(FontWeight.Bold) // A new button with will call explicitStartAbility() when clicked. Button("CLICKME") .onClick(this.explicitStartAbility) // explicitStartAbility见下面示例代码 // ... } .width('100%') } .height('100%') } async explicitStartAbility() { try { // Explicit want with abilityName specified. let want = { deviceId: "", bundleName: "com.example.myapplication", abilityName: "calleeAbility" }; let context = getContext(this) as common.UIAbilityContext; await context.startAbility(want); console.info(explicit start ability succeed); } catch (error) { console.info(explicit start ability failed with ${error.code}); } } }

4、执行

在这里插入图片描述

5.使用隐式Want打开网址

1、module.json5配置

"skills": [ { "entities": [ "entity.system.browsable" // ... ], "actions": [ "ohos.want.action.viewData" // ... ], "uris": [ { "scheme": "https", "host": "www.test.com", "port": "8080", // prefix matching "pathStartWith": "query", "type": "text/*" }, { "scheme": "http", // ... } // ... ] }, ]

在这里插入图片描述

2、定义跳转函数

async implicitStartAbility() { try { let 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": "www.test.com:8080/query/stude…", "type": "text/plain" } let context = getContext(this) as common.UIAbilityContext; await context.startAbility(want) console.info(explicit start ability succeed) } catch (error) { console.info(explicit start ability failed with ${error.code}) } }

匹配条件	匹配结果
`want`内`action`不为空，且被`skills`内`action`包括	匹配成功
`want`内`entities`不为空，且被`skills`内`entities`包括	匹配成功
`skills`内`uris`拼接为`https://www.test.com:8080/query` ( ``为通配符)包含`want`内`uri`，匹配成功
`want`内`type`不为空，且被`skills`内`type`包含	匹配成功