鸿蒙HarmonyOS实战-Stage模型（信息传递载体Want）_want的基本概念(2)

程序员锋范

已于 2024-04-11 12:32:49 修改

阅读量890

点赞数 13

分类专栏： 2024年程序员学习文章标签： harmonyos 华为

于 2024-04-11 12:32:48 首次发布

本文链接：https://blog.csdn.net/weixin_58134620/article/details/137634424

版权

2024年程序员学习专栏收录该内容

237 篇文章 0 订阅

订阅专栏

系统将调用方传入的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”,
// …
}
// …
]
},
]