文档开发者中心
我的
|

HarmonyOS 5

应用跳转出现不相关应用选项

APP跳转其他应用时,出现与当前应用不相关的应用。

点赞
收藏
回复
1
分享
举报
浏览142 发布于2025-09-24 01:00未知归属地
全部评论
最多点赞
最新发布
最早发布

【背景知识】 应用跳转是指从一个应用跳转至另外一个应用,传递相应的数据、执行特定的功能。

  • 应用跳转有两种类型:

    1. 拉起指定应用:拉起方应用明确指定跳转的目标应用,来实现应用跳转。指向性跳转可以分为指定应用链接、指定Ability两种方式。
      • 指定应用链接(推荐):通过openLink或startAbility接口来指定应用链接,拉起目标应用页面。
      • 指定Ability(不推荐):通过startAbility接口指定具体的Ability(即显式Want方式),拉起目标应用页面。
    2. 拉起指定类型的应用:拉起方应用通过指定应用类型,拉起垂类应用面板。该面板将展示目标方接入的垂域应用,由用户选择打开指定应用。
      • 通过startAbilityByType接口拉起垂类面板,类似下图效果:
      • 开发者可通过特定的业务类型如导航、金融、邮件等,调用startAbilityByType接口拉起对应的垂域面板,该面板将展示目标方接入的垂域应用,由用户选择打开指定应用以实现相应的垂类意图。
      • 匹配规则参考:
  • 使用Deep Linking实现应用间跳转: 采用Deep Linking进行跳转时,系统会根据接口中传入的uri信息,在本地已安装的应用中寻找到符合条件的应用并进行拉起。当匹配到多个应用时,会拉起应用选择框。Deep Linking基于隐式Want匹配机制中的uri匹配来查询、拉起目标应用,参考隐式Want的uri匹配规则。

  • 目标应用操作指导:

    1. 为了能够支持被其他应用访问,目标应用需要在module.json5配置文件中配置skills标签。参考uris标签说明,示例如下:
      收起
      自动换行
      深色代码主题
      复制
      {
        "module": {
          // ...
          "abilities": [
            {
              // ...
              "skills": [
                {
                  "entities": [
                    "entity.system.home"
                  ],
                  "actions": [
                    "action.system.home"
                  ]
                },
                {
                  "actions": [
                    // actions不能为空,actions为空会造成目标方匹配失败。
                    "ohos.want.action.viewData"
                  ],
                  "uris": [
                    {
                      // scheme必选,可以自定义,以link为例,需要替换为实际的scheme
                      "scheme": "link",
                      // host必选,配置待匹配的域名
                      "host": "www.example.com"
                    }
                  ]
                } // 新增一个skill对象,用于跳转场景。如果存在多个跳转场景,需配置多个skill对象。
              ]
            }
          ]
        }
      }
      
    2. 当在module.json5文件的skills字段中声明uris时,主要包含如下字段。
      • scheme:协议名称。常见的取值有http、https、file、ftp等,也可以自定义。
      • host:域名或IP地址。例如域名developer.huawei.com或IP地址127.0.0.1。
      • port:端口号。例如developer.huawei.com:80后面的80即为端口号。
      • path:路径,表示域名服务器上的目录或文件路径,该字段在scheme存在时才有意义。path字段不支持通配符,如果需要使用通配符,可以采用pathRegex字段。
      • pathStartWith:路径前缀,该字段在scheme存在时才有意义,表示域名服务器上的目录或文件路径的前缀,用于前缀匹配。
      • pathRegex:路径正则,该字段在scheme存在时才有意义,表示域名服务器上的目录或文件路径的正则表达式,用于正则匹配。
      • linkFeature:应用的功能类型(如文件打开、分享、导航等)。取值为长度不超过127字节的字符串,不支持中文。

【问题定位】

  • 如果是拉起指定应用,需要确认应用want拉起链接(uri)与目标应用module.json5配置文件中的uris标签中的信息匹配上,如果多个应用的URl配置相同,应用跳转时匹配到同多个应用,则会拉起应用选择框。

  • 如果是拉起指定类型的应用,需要确认应用的module.json5配置文件中linkFeature声明的功能类型是否一致,如果一致就会将应用都拉起,让用户选择打开方式。

【分析结论】

  • 应用在使用want拉起链接时的uri填写不准确与多个应用匹配成功。
  • 被拉起应用的module.json5配置信息中关于skills的linkFeature标签信息配置错误。

【修改建议】

  • 将应用want拉起的uri信息填写准确。
  • 修改被拉起应用的module.json5文件的配置信息中的linkFeature标签信息。
展开全部
1楼回复于2025-09-24 01:00 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。