【最新鸿蒙应用开发】—

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

news2024/12/23 23:19:04

信息传递载体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 omitted
  entities: [ '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匹配成功。

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