上海古都建筑设计集团,上海办公室装修设计公司,上海装修公司高质量的内容分享社区,上海装修公司我们不是内容生产者,我们只是上海办公室装修设计公司内容的搬运工平台

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

guduadmin351月前

【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第1张

🏆 作者简介,愚公搬代码

🏆《头衔》:华为云特约编辑,华为云云享专家,华为开发者专家,华为产品云测专家,CSDN博客专家,CSDN商业化专家,阿里云专家博主,阿里云签约作者,腾讯云优秀博主,腾讯云内容共创官,掘金优秀博主,51CTO博客专家等。

🏆《近期荣誉》:2023年华为云十佳博主,2022年CSDN博客之星TOP2,2022年华为云十佳博主等。

🏆《博客内容》:.NET、Java、Python、Go、Node、前端、IOS、Android、鸿蒙、Linux、物联网、网络安全、大数据、人工智能、U3D游戏、小程序等相关领域知识。

🏆🎉欢迎 👍点赞✍评论⭐收藏

文章目录

  • 🚀前言
  • 🚀一、信息传递载体Want
    • 🔎1.Want概述
      • 🦋1.1 Want的定义与用途
      • 🦋1.2 Want的类型
      • 🔎2.显式Want与隐式Want匹配规则
        • 🦋2.1 隐式Want匹配原理详解
          • ☀️2.1.1 want参数的action匹配规则
          • ☀️2.1.2 want参数的entities匹配规则
          • ☀️2.1.3 want参数的uri和type匹配规则
          • ☀️2.1.4 uri匹配规则
          • ☀️2.1.5 type匹配规则
          • 🔎3.常见action与entities
            • 🦋3.1 action
            • 🦋3.2 entities
            • 🔎4.使用显式Want启动Ability
            • 🔎5.使用隐式Want打开网址
            • 🔎6.应用间使用Want分享数据
            • 🚀感谢:给读者的一封信

              🚀前言

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

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

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

              🚀一、信息传递载体Want

              🔎1.Want概述

              🦋1.1 Want的定义与用途

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

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

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

              【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第2张

              🦋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匹配失败

              【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第3张

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

              【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第4张

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

              【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第5张

              调用方传入的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不为空其他情况匹配失败

              【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第6张

              ☀️2.1.4 uri匹配规则

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

              s_uri.schemes_uri.hosts_uri.paths_uri.pathStartWiths_uri.pathRegexw_uri匹配结果
              abc://def成功
              失败
              abc://defabc://def成功
              abc://defdef://abc失败
              /path/path成功
              /path/path/123失败
              /pathStart/pathStart成功
              /pathStart/pathStart2失败
              ^/regex$/regex成功
              ^/regex$/path/regex失败
              abc://def/pathabc://def/path成功
              abc://def/pathabc://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

                【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第7张

                2、被启动方

                同理新建calleeAbility

                【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第8张

                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、执行

                【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第9张

                🔎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",
                        // ...
                      }
                      // ...
                    ]
                  },
                ]
                

                【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第10张

                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}`)
                    }
                 }
                
                匹配条件匹配结果
                want内action不为空,且被skills内action包括匹配成功
                want内entities不为空,且被skills内entities包括匹配成功
                skills内uris拼接为https://www.test.com:8080/query* ( *为通配符)包含want内uri,匹配成功
                want内type不为空,且被skills内type包含匹配成功

                【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第11张

                3、运行

                【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第12张

                🔎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[]有一一对应的关系

                【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第13张

                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元钱的支持。这个金额不会对您的财务状况造成负担,但它会对我继续创作高质量的内容产生积极的影响。

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

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

                【愚公系列】2023年12月 HarmonyOS教学课程 051-Stage模型(信息传递载体Want),在这里插入图片描述,第14张

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

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

网友评论

搜索
最新文章
热门文章
热门标签
 
 已婚女人梦见下雨挨淋  1983年属猪的婚配  周公解梦梦见月经血是什么预兆