鸿蒙Harmony开发实战（5.0 Beta）显式Want跳转切换应用链接跳转规范详解

最新推荐文章于 2024-09-24 14:59:40 发布
最新推荐文章于 2024-09-24 14:59:40 发布
阅读量996 收藏 16
点赞数 21
分类专栏： OpenHarmony 鸿蒙开发 HarmonyOS 文章标签： harmonyos 华为 前端 鸿蒙 鸿蒙系统 移动开发 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yguyf1235/article/details/142179063
版权

 鸿蒙开发往期必看：

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

 “一杯冰美式的时间” 了解鸿蒙HarmonyOS Next应用开发路径！

启动其他应用的UIAbility

  1. 将待跳转的应用安装到设备，在其对应UIAbility的module.json5配置文件中配置skills标签的entities字段、actions字段和uri字段：

    • “actions"列表中包含"ohos.want.action.viewData”。
    • “entities"列表中包含"entity.system.browsable”。
    • "uris"列表中包含"scheme"为"https"且"domainVerify"为true的元素。uri的匹配规则参考uri匹配, domainVerify为true代表开启域名检查，通过applinking匹配该应用时需经过配置的域名校验后才能匹配到。applinking域名配置具体可参考AppLinking。
    {
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "skills": [
          {
            "entities": [
              "entity.system.browsable"
            ],
            "actions": [
              "ohos.want.action.viewData"
            ],
            "uris": [
              {
                "scheme": "https",
                "host": "www.example.com",
              }
            ],
          "domainVerify": true
          }
        ]
      }
    ]
  }
}

  2. 调用方通过openLink接口执行跳转，在接口入参需要传入转换后的link和配置options, 不再传入bundleName、moduleName和abilityName。系统会根据传入的link匹配到符合skill配置的应用。

    • 当options中的appLinkingOnly为true时，匹配到的应用会经过应用市场域名检查（需联网）返回域名校验检查的唯一匹配项或未匹配结果。
    • 当options中的appLinkingOnly为false时，会优先尝试以AppLinking的方式拉起，如果没有匹配的应用则改为使用DeepLinking的方式拉起目标应用。

    具体请参考AppLinking开发指南。

    import { common, OpenLinkOptions } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

const TAG: string = '[UIAbilityComponentsOpenLink]';
const DOMAIN_NUMBER: number = 0xFF00;

@Entry
@Component
struct Index {
  build() {
    Button('start link', { type: ButtonType.Capsule, stateEffect: true })
      .width('87%')
      .height('5%')
      .margin({ bottom: '12vp' })
      .onClick(() => {
        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
        // let want: Want = {
        //   bundleName: "com.test.example",
        //   moduleName: "entry",
        //   abilityName: "EntryAbility"
        // };
        // try {
        //   context.startAbility(want)
        //     .then(() => {
        //       hilog.info(DOMAIN_NUMBER, TAG, 'startAbility success.');
        //     }).catch((err: BusinessError) => {
        //       hilog.error(DOMAIN_NUMBER, TAG, `startAbility failed. Code is ${err.code}, message is ${err.message}`);
        //     })
        // } catch (paramError) {
        //   hilog.error(DOMAIN_NUMBER, TAG, `Failed to startAbility. Code is ${paramError.code}, message is ${paramError.message}`);
        // }
        let link: string = "https://www.example.com";
        let openLinkOptions: OpenLinkOptions = {
          // 匹配的abilities选项是否需要通过AppLinking域名校验，匹配到唯一配置过的应用ability
          appLinkingOnly: true,
          // 同want中的parameter，用于传递的参数
          parameters: {demo_key: "demo_value"}
        };

        try {
          context.openLink(link, openLinkOptions)
            .then(() => {
              hilog.info(DOMAIN_NUMBER, TAG, 'open link success.');
            }).catch((err: BusinessError) => {
              hilog.error(DOMAIN_NUMBER, TAG, `open link failed. Code is ${err.code}, message is ${err.message}`);
            })
        } catch (paramError) {
          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start link. Code is ${paramError.code}, message is ${paramError.message}`);
        }
      })
  }
}

启动其他应用的UIAbility并获取返回结果

  1. 将待跳转的应用安装到设备，在其对应UIAbility的module.json5配置文件中配置skills标签的entities字段、actions字段和uri字段：

    • “actions"列表中包含"ohos.want.action.viewData”。
    • “entities"列表中包含"entity.system.browsable”。
    • "uris"列表中包含"scheme"为"https"且"domainVerify"为true的元素。uri的匹配规则参考uri匹配, domainVerify为true代表开启域名检查，通过applinking匹配该应用时需经过配置的域名校验后才能匹配到。applinking域名配置具体可参考App Linking。
    {
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "skills": [
          {
            "entities": [
              "entity.system.browsable"
            ],
            "actions": [
              "ohos.want.action.viewData"
            ],
            "uris": [
              {
                "scheme": "https",
                "host": "www.example.com",
              }
            ],
          "domainVerify": true
          }
        ]
      }
    ]
  }
}

  2. 调用方通过openLink接口执行跳转，在接口入参需要传入转换后的link和配置options, 不再传入bundleName、moduleName和abilityName。系统会根据传入的link匹配到符合skills配置的应用。AbilityResult回调结果返回通过入参传入回调函数，在启动ability停止自身后返回给调用方的信息。启动成功和失败结果仍通过Promise返回。

    • 当options中的appLinkingOnly为true时，匹配到的应用会经过应用市场域名检查（需联网）返回域名校验检查的唯一匹配项或未匹配结果。
    • 当options中的appLinkingOnly为false时，会优先尝试以AppLinking的方式拉起，如果没有匹配的应用则改为使用DeepLinking的方式拉起目标应用。
      具体请参考AppLinking开发指南。
    import { common, OpenLinkOptions } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

const TAG: string = '[UIAbilityComponentsOpenLink]';
const DOMAIN_NUMBER: number = 0xFF00;

@Entry
@Component
struct Index {
  build() {
    Button('start link', { type: ButtonType.Capsule, stateEffect: true })
      .width('87%')
      .height('5%')
      .margin({ bottom: '12vp' })
      .onClick(() => {
        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
        // let want: Want = {
        //   bundleName: "com.test.example",
        //   moduleName: "entry",
        //   abilityName: "EntryAbility"
        // };
        // try {
        //   context.startAbilityForResult(want)
        //     .then((data) => {
        //       hilog.info(DOMAIN_NUMBER, TAG, 'startAbility success. data:' + JSON.stringify(data));
        //     }).catch((err: BusinessError) => {
        //       hilog.error(DOMAIN_NUMBER, TAG, `startAbility failed. Code is ${err.code}, message is ${err.message}`);
        //     })
        // } catch (paramError) {
        //   hilog.error(DOMAIN_NUMBER, TAG, `Failed to startAbility. Code is ${paramError.code}, message is ${paramError.message}`);
        // }
        let link: string = "https://www.example.com";
        let openLinkOptions: OpenLinkOptions = {
          // 匹配的abilities选项是否需要通过AppLinking域名校验，匹配到唯一配置过的应用ability
          appLinkingOnly: true,
          // 同want中的parameter，用于传递的参数
          parameters: {demo_key: "demo_value"}
        };

        try {
          context.openLink(link, openLinkOptions, (err, data) => {
            // AbilityResult callback回调，仅在被拉起ability死亡时触发
            hilog.info(DOMAIN_NUMBER, TAG, 'open link success. Callback result:' + JSON.stringify(data));
          }).then(() => {
            hilog.info(DOMAIN_NUMBER, TAG, 'open link success.');
          }).catch((err: BusinessError) => {
            hilog.error(DOMAIN_NUMBER, TAG, `open link failed. Code is ${err.code}, message is ${err.message}`);
          })
        } catch (paramError) {
          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start link. Code is ${paramError.code}, message is ${paramError.message}`);
        }
      })
  }
}

最后

小编在之前的鸿蒙系统扫盲中，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）路线图、文档、视频、用来跟着学习是非常有必要的。 

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员

→ 鸿蒙全栈开发学习笔记 希望这一份鸿蒙学习文档能够给大家带来帮助~

派大星、来咯
关注
专栏目录
基于原生能力的跨应用跳转
hongxiaomeng的博客
06-04 403
5分钟速通鸿蒙开发第一篇：开发环境
Android技术之家
11-20 219
1.前言 鸿蒙系统（HarmonyOS）是华为于2019年8月9日在东莞举行华为开发者大会发布的1.0版本操作系统，不知不觉现在已经是2023年中了，HarmonyOS的版本也更新到了3.1了，这篇文章将作为起点，一步一步入门HarmonyOS开发。（ps：文章的部分内容来自于HarmonyOS的开发指南(3.1/4.0)，使用Stage模型，有兴趣可以自行参考，此外文章会尽量将HarmonyOS...
【鸿蒙实战开发】基于原生能力的跨应用跳转
HarmonyOSMN的博客
07-05 1118
使用原生能力startability启动其他应用前，开发者需要判断目标应用是否安装，从而执行不同的逻辑，例如：场景一：支付时商户根据实际情况去判断，拉起支付应用还是h5页面。场景二：分享场景与支付场景，需要列出多个用户可跳转的应用。显示效果：1.支付应用存在，拉起支付应用。2.支付应用不存在，拉起h5页面进行支付。准备被拉起方的app信息，其中目标app的图标需要拉起方应用自己准备。uri字段规格详见文末的常见问题Q1。添加按钮，点击出现支付应用列。
写给Android开发者的HarmonyOS入门指南
wangjie_de的博客
02-21 1352
自2023华为开发者大会之后，HarmonyOS后续版本将不再支持Android应用的说法愈演愈烈，虽然网络上有很多相关的新闻，但大多都是基于HarmoneyOS NEXT 开发者预览版不支持Android应用安装做的推测，目前未见华为官方正式发布说明。也有人说目前的鸿蒙开发工具里面都没有集成，但这也只能说明原生的鸿蒙应用无法安装在Android系统上，这个说法尚未定论。但是HarmonyOS的发展是必然的，作为移动端的从业人员，自然不能停滞不前，今天我们就来走进HarmoneyOS的世界。
鸿蒙Harmony开发实战（5.0 Beta）App Linking实现应用间跳转规范详解
yguyf1235的博客
09-12 738
使用App Linking进行跳转时，系统会根据接口传入的uri信息（HTTPS链接）将用户引导至目标应用中的特定内容，无论应用是否已安装，用户都可以访问到链接对应的内容，整个跳转体验相比Deep Linking方式更加顺畅。
鸿蒙Harmony开发实战（5.0 Beta）Deep Linking应用间跳转规范详解
yguyf1235的博客
09-12 366
​ 采用Deep Linking进行跳转时，系统会根据接口中传入的uri信息，按照uri匹配规则在本地已安装的应用中，寻找到符合URL skill配置的应用并进行拉起。当匹配到多个应用时，会拉起应用选择框。
鸿蒙Harmony开发实战（5.0 Beta）任务（Mission）与启动模式规范详解
yguyf1235的博客
09-12 680
每个UIAbility实例对应的Mission都保留有该UIAbility实例的快照（Snapshot），UIAbility实例销毁后，Mission信息（包括UIAbility信息和任务快照）依然会保留，直到用户删除该任务。
HarmonyOS开发实战（ Beta5.0）系统提供的接口实践规范
weixin_55362248的博客
09-05 1307
在应用开发中，经常会调用系统提供的接口，比如读取本地文件、处理服务端数据等等。若对接口使用不合理，可能引起延迟、卡顿、丢帧等性能问题。本文以如下系统提供的接口为例，总结了使用中的注意事项。
鸿蒙HarmonyOS开发（5.0 Beta）JS组件通用方法详解
yguyf1235的博客
09-09 994
当组件通过id属性标识后，可以使用该id获取组件对象并调用相关组件方法。
HarmonyOS开发实战（ Beta5.0）文字展开收起案例实践详解
weixin_55362248的博客
09-19 1082
想要实现文字收起，难点在于如何判断展示多少文字可以达到只显示到指定行数（以两行为例）的目的。通过判断文字其在容器内的高度来将文字缩减到指定行数，可以实现收起效果的目的。
华为HarmonyOS鸿蒙高级应用实站课程-网盘链接提取码下载 .txt
02-17
华为HarmonyOS鸿蒙系统实战应用开发课程，一次课程带领同学们了解HarmonyOS鸿蒙系统。课程分为两个阶段，第一部分是HarmonyOS基础开发阶段，第二部分是HarmonyOS进阶开发阶段。课程从内向外逐步深入的剖析和讲解...
全网首发黑马程序员鸿蒙 HarmonyOS NEXT星河版零基础入门到实战，零基础也能快速入门鸿蒙开发教程2
05-16
本教程旨在帮助没有编程基础的学员快速掌握HarmonyOS的开发技能，通过丰富的实例和清晰的讲解，让学习者能够从零开始，逐步进入鸿蒙应用开发的世界。 在这一系列的课程中，涵盖了多个关键知识点，包括但不限于： 1...
HarmonyOS 2.0鸿蒙应用开发实战教程视频教程2.4G
06-16
鸿蒙应用开发实战教程视频教程2.4G涵盖了从基础到进阶的全面内容，帮助开发者掌握在HarmonyOS上构建应用的核心技能。 在本教程中，你将学习到以下几个重要的知识点： 1. **HarmonyOS概述**：了解HarmonyOS的设计...
HarmonyOS 2.0鸿蒙应用开发实战教程视频教程
06-16
本教程将深入探讨HarmonyOS 2.0的应用开发实践，帮助开发者掌握其核心概念和技术。 首先，我们来了解HarmonyOS的架构。HarmonyOS采用微内核设计，这种设计使得系统更加安全且高效。它的层次结构包括硬件抽象层、...
鸿蒙HarmonyOS实战-UIAbility页面跳转_鸿蒙os开发uiabillty之间的跳转
2401_84181108的博客
04-21 867
android.settings.INPUT_METHOD_SUBTYPE_SETTINGS 【API 11及以上】 // 跳转 语言选择界面 【多国语言选择】android.settings.NFC_SETTINGS 显示NFC设置。android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS 跳转到应用程序界面【所有的】android.settings.INTERNAL_STORAGE_SETTINGS 跳转存储设置界面【内部存储】
HarmonyOS NEXT应用开发案例实践总结合集
weixin_55362248的博客
09-20 466
随着应用代码的复杂度提升，为了使应用有更好的可维护性和可扩展性，良好的应用架构设计变得尤为重要。本篇文章将整理出一个应用通用架构的设计思路，以减少模块间的耦合、提升团队开发效率，为开发者呈现一个清晰且结构化的开发框架。 本文以“应用通用开发范例App”为例，从分层架构设计和模块化设计的方面介绍应用的架构组成。
HarmonyOS第一课-应用程序框架基础习题答案
暴走哥丶AS
09-18 715
本题库为最新的HarmonyOS第一课的答案题库
harmonyos面试题
最新发布
田兴的博客
09-24 417
你说你开发过项目，那么，开发鸿蒙项目流程是怎么样的?鸿蒙的刷新机制是怎么样的，多层嵌套时，是从构建开始刷新吗。页面的生命周期有哪些?UAbility的生命周期呢?对于一些公共的样式你是怎么傲的?你在项目中用过线程通信吗，线程是怎么进行通信的?如果方便的话，简单介绍并演示一下你做的项目?你现在用的是鸿蒙几的api和编辑器?你项目中调到了那些难点，如何解决的?弹室UI是怎么在页面UI中使用的。你是什么时候开始学习鸿蒙的?发布的应用用什么监控的日志呢。常用的修饰符有愿些介绍一下。你项目用到了鸿蒙那些功能?
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值