HarmonyOS应用开发学习笔记 Want概述Ability跳转

一、Want的定义与用途

  • Want是对象间信息传递的载体,可以用于应用组件间的信息传递。其使用场景之一是作为startAbility()的参数,包含了指定的启动目标以及启动时需携带的相关数据,如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当UIAbilityA启动UIAbilityB并需要传入一些数据给UIAbilityB时,Want可以作为一个载体将数据传给UIAbilityB。
  • 有点类似Android中Intent的作用,acitivity,server,通道之间信息传递的载体。

在这里插入图片描述

二、Want的类型

1、显式Want:在启动Ability时指定了abilityName和bundleName的Want称为显式Want。

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

2、隐式Want:在启动UIAbility时未指定abilityName的Want称为隐式Want。

let wantInfo = {

    action: 'ohos.want.action.search',
    entities: [ 'entity.system.browsable' ],
    uri: 'https://www.test.com:8080/query/student',
    type: 'text/plain',
    
};

根据系统中待匹配Ability的匹配情况不同,使用隐式Want启动Ability时会出现以下三种情况。

1.未匹配到满足条件的Ability:启动失败。
2.匹配到一个满足条件的Ability:直接启动该Ability。
3.匹配到多个满足条件的Ability(UIAbility):弹出选择框让用户选择。

调用方传入的want参数中不带有abilityName和bundleName,则不允许通过隐式Want启动所有应用的ServiceExtensionAbility。

调用方传入的want参数中带有bundleName,则允许使用startServiceExtensionAbility()方法隐式Want启动ServiceExtensionAbility,默认返回优先级最高的ServiceExtensionAbility,如果优先级相同,返回第一个。

三、Want参数说明

名称 描述
deviceId 表示目标Ability所在设备ID。如果未设置该字段,则表明本设备。
bundleName 表示目标Ability所在应用名称。
moduleName 表示目标Ability所属的模块名称。
abilityName 表示目标Ability名称。如果未设置该字段,则该Want为隐式。如果在Want中同时指定了bundleName,moduleName和abilityName,则Want可以直接匹配到指定的Ability。
uri 表示携带的数据,一般配合type使用,指明待处理的数据类型。如果在Want中指定了uri,则Want将匹配指定的Uri信息,包括scheme, schemeSpecificPart, authority和path信息。
type 表示携带数据类型,使用MIME类型规范。例如:“text/plain”、"image/*"等。
action 表示要执行的通用操作(如:查看、分享、应用详情)。在隐式Want中,您可定义该字段,配合uri或parameters来表示对数据要执行的操作。如打开,查看该uri数据。例如,当uri为一段网址,action为ohos.want.action.viewData则表示匹配可查看该网址的Ability。
entities 表示目标Ability额外的类别信息(如:浏览器,视频播放器),在隐式Want中是对action的补充。在隐式Want中,您可定义该字段,来过滤匹配UIAbility类别,如必须是浏览器。例如,在action字段的举例中,可存在多个应用声明了支持查看网址的操作,其中有应用为普通社交应用,有的为浏览器应用,您可通过entity.system.browsable过滤掉非浏览器的其他应用。
flags 表示处理Want的方式。例如通过wantConstant.Flags.FLAG_ABILITY_CONTINUATION表示是否以设备间迁移方式启动Ability。
parameters 此参数用于传递自定义数据,通过用户自定义的键值对进行数据填充,具体支持的数据类型如Want API所示。

代码示例:

let wantInfo = {
    deviceId: '', // deviceId为空表示本设备
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
    moduleName: 'module1', // moduleName非必选
    parameters: { // 自定义信息
        info: '来自EntryAbility Index页面',
    },
}
// context为调用方UIAbility的AbilityContext
this.context.startAbility(wantInfo).then(() => {
    // ...
}).catch((err) => {
    // ...
})

四、显式Want与隐式Want匹配规

官方文档

  • want参数的action匹配规则
    在这里插入图片描述

  • want参数的entities匹配规则
    在这里插入图片描述

  • want参数的uri和type匹配规则

在这里插入图片描述
在这里插入图片描述

1、 HarmoryOS Ability页面的生命周期
2、 @Component自定义组件
3、HarmonyOS 应用开发学习笔记 ets组件生命周期
4、HarmonyOS 应用开发学习笔记 ets组件样式定义 @Styles装饰器:定义组件重用样式 @Extend装饰器:定义扩展组件样式
5、HarmonyOS 应用开发学习笔记 state状态管理概述
6、HarmonyOS应用开发学习笔记 包名、icon图标,应用名修改 UIAbility组件介绍、UIAbility启动模式、UIAbility组件基本用法
7、HarmonyOS应用开发学习笔记 UIAbility组件与UI的数据同步 EventHub、globalThis
8、HarmonyOS应用开发学习笔记 UIAbility组件间交互 UIAbility启动,页面跳转结果回调
9、HarmonyOS应用开发学习笔记 应用上下文Context 获取文件夹路径

相关推荐

最近更新

  1. TCP协议是安全的吗?

    2024-01-10 06:16:03       18 阅读
  2. 阿里云服务器执行yum,一直下载docker-ce-stable失败

    2024-01-10 06:16:03       19 阅读
  3. 【Python教程】压缩PDF文件大小

    2024-01-10 06:16:03       18 阅读
  4. 通过文章id递归查询所有评论(xml)

    2024-01-10 06:16:03       20 阅读

热门阅读

  1. Linux和windows进程同步与线程同步那些事儿(一)

    2024-01-10 06:16:03       28 阅读
  2. Ubuntu and Mac OSX之间传输文件(共享文件夹方法)

    2024-01-10 06:16:03       41 阅读
  3. Python数据类型转换

    2024-01-10 06:16:03       35 阅读
  4. #{}和${}的区别?

    2024-01-10 06:16:03       23 阅读
  5. 离线安装docker和docker-compose

    2024-01-10 06:16:03       40 阅读
  6. 深度学习中Epoch和Batch Size的关系

    2024-01-10 06:16:03       35 阅读
  7. 树莓派Debian系统中如何用mDNS广播自己的ip地址

    2024-01-10 06:16:03       33 阅读
  8. [力扣 Hot100]Day1 两数之和

    2024-01-10 06:16:03       41 阅读
  9. 【docker】docker-compose.yml 语法详解

    2024-01-10 06:16:03       34 阅读
  10. nginx upstream负载均衡模块

    2024-01-10 06:16:03       28 阅读
  11. xcode 14.3升级 pod升级

    2024-01-10 06:16:03       29 阅读