【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want)

举报
愚公搬代码 发表于 2023/12/31 20:08:08 2023/12/31
【摘要】 🏆 作者简介,愚公搬代码🏆《头衔》:华为云特约编辑,华为云云享专家,华为开发者专家,华为产品云测专家,CSDN博客专家,CSDN商业化专家,阿里云专家博主,阿里云签约作者,腾讯云优秀博主,腾讯云内容共创官,掘金优秀博主,51CTO博客专家等。🏆《近期荣誉》:2023年华为云十佳博主,2022年CSDN博客之星TOP2,2022年华为云十佳博主等。🏆《博客内容》:.NET、Java、...

🏆 作者简介,愚公搬代码
🏆《头衔》:华为云特约编辑,华为云云享专家,华为开发者专家,华为产品云测专家,CSDN博客专家,CSDN商业化专家,阿里云专家博主,阿里云签约作者,腾讯云优秀博主,腾讯云内容共创官,掘金优秀博主,51CTO博客专家等。
🏆《近期荣誉》:2023年华为云十佳博主,2022年CSDN博客之星TOP2,2022年华为云十佳博主等。
🏆《博客内容》:.NET、Java、Python、Go、Node、前端、IOS、Android、鸿蒙、Linux、物联网、网络安全、大数据、人工智能、U3D游戏、小程序等相关领域知识。
🏆🎉欢迎 👍点赞✍评论⭐收藏

🚀前言

应用中的信息传递是为了实现各种功能和交互。信息传递可以帮助用户和应用之间进行有效的沟通和交流。通过信息传递,应用可以向用户传递重要的消息、通知和提示,以提供及时的反馈和指导。同时,用户也可以通过信息传递向应用发送指令、请求和反馈,以实现个性化的需求和操作。

信息传递还可以帮助应用之间实现数据的共享和交互。通过信息传递,不同应用可以实现数据的互通,以实现更多的功能和服务。例如,一个购物应用可以通过信息传递与支付应用进行数据交互,以实现支付功能;一个社交媒体应用可以通过信息传递与地图应用进行数据交互,以实现位置分享功能。

此外,信息传递还可以帮助应用之间实现联动和协作。通过信息传递,应用可以实现多个功能的组合和协同,以提供更加丰富和综合的服务。例如,一个音乐应用可以与闹钟应用进行信息传递,以实现在特定时间播放特定的音乐。

🚀一、信息传递载体Want

🔎1.Want概述

🦋1.1 Want的定义与用途

HarmonyOS中的"Want"是一个用于定义和控制应用程序之间通信的基本概念。它可以用来描述一个应用程序对某个特定操作的需求或意愿,比如获取某个设备的位置信息、访问某个传感器的数据等。

使用"Want"可以实现应用程序之间的无缝协作和互操作。通过定义和使用"Wants",应用程序可以根据自身的需求发送请求,并且可以接收和处理其他应用程序发送的请求。这种机制能够促进应用程序之间的交互和共享,并且使得整个系统更加智能和高效。

"Wants"的使用可以带来许多好处。首先,它可以简化应用程序之间的通信和协作,减少开发人员的工作量。其次,它可以增强系统的灵活性和可扩展性,使得应用程序能够动态地适应不同的环境和设备。最后,它可以提供更加个性化和智能化的用户体验,使得应用程序能够更好地理解用户的需求并作出相应的反应。

在这里插入图片描述

🦋1.2 Want的类型

在HarmonyOS中,信息传递载体Want的类型可以分为两种:显式Want和隐式Want。

  1. 显式Want:显式Want是指明确指定要操作的组件或服务的Want。通过显式Want,可以精确地指定要传递给目标组件或服务的信息,并指定具体的要执行的操作。显式Want会包含组件名和操作类型等明确的指令信息。例如,可以使用显式Want来启动指定的Activity或调用指定的服务。
let wantInfo = {
    deviceId: '', // deviceId为空表示本设备
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
}
  1. 隐式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: 'https://www.test.com:8080/query/student',
    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.scheme 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": "https://www.test.com:8080/query/student",
            "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}`)
    }
 }
匹配条件 匹配结果
wantaction不为空,且被skillsaction包括 匹配成功
wantentities不为空,且被skillsentities包括 匹配成功
skillsuris拼接为https://www.test.com:8080/query* ( *为通配符)包含wanturi,匹配成功
wanttype不为空,且被skillstype包含 匹配成功

在这里插入图片描述
3、运行

在这里插入图片描述

🔎6.应用间使用Want分享数据

1、分享方

读取文件

import fileIO from '@ohos.fileio';

// let path = ...
// file open where path is a variable contains the file path.
let fileFd = fileIO.openSync(path, 0o102, 0o666);

传输文件信息构造

import wantConstant from '@ohos.ability.wantConstant';

// let path = ...
// let fileFd = ...
// let fileSize = ...
let want = {
    // This action is used to implicitly match the application selctor.
    action: wantConstant.Action.ACTION_SELECT,
    // This is the custom parameter in the first layer of want
    // which is intended to add info to application selector.
    parameters: {
        // The MIME type of pdf
        "ability.picker.type": "application/pdf",
        "ability.picker.fileNames": [path],
        "ability.picker.fileSizes": [fileSize],
        // This a nested want which will be directly send to the user selected application.         
        "ability.want.params.INTENT": {
            "action": "ohos.want.action.sendData",
            "type": "application/pdf",
            "parameters": {
               "keyFd": {"type": "FD", "value": fileFd}
            }
        }
    }
}
字段 说明
ability.picker.type 应用选择器根据该字段渲染相应的文件类型图标
ability.picker.fileNames 应用选择器根据该字段展示文件名
ability.picker.fileSizes 应用选择器根据该字段展示文件大小。以字节为单位
ability.picker.fileNames[] 文件名数组,与ability.picker.fileSizes[]有一一对应的关系
ability.picker.fileSizes[] 文件大小数组,与ability.picker.fileNames[]有一一对应的关系

在这里插入图片描述

2、被分享方

定义skills

"skills": [
  {
    "entities": [
      // ...
    ],
    "actions": [
        "ohos.want.action.sendData"
        // ...
    ],
    "uris": [
      {
        "type": "application/pdf"
      },
      // ...
    ]
  },
]

2、接收数据

onCreate(want, launchParam) {
  // note when keyFd is undefined, app crash will happen.
  if (want["parameters"]["keyFd"] !== undefined) {
    // receive file descriptor
    let fd = want["parameters"]["keyFd"].value;
    // ...
  }
}

🚀感谢:给读者的一封信

亲爱的读者,

我在这篇文章中投入了大量的心血和时间,希望为您提供有价值的内容。这篇文章包含了深入的研究和个人经验,我相信这些信息对您非常有帮助。

如果您觉得这篇文章对您有所帮助,我诚恳地请求您考虑赞赏1元钱的支持。这个金额不会对您的财务状况造成负担,但它会对我继续创作高质量的内容产生积极的影响。

我之所以写这篇文章,是因为我热爱分享有用的知识和见解。您的支持将帮助我继续这个使命,也鼓励我花更多的时间和精力创作更多有价值的内容。

如果您愿意支持我的创作,请扫描下面二维码,您的支持将不胜感激。同时,如果您有任何反馈或建议,也欢迎与我分享。

在这里插入图片描述

再次感谢您的阅读和支持!

最诚挚的问候, “愚公搬代码”

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。