HarmonyOS的连接艺术之二：精准控制目标应用

本文旨在深入探讨华为鸿蒙HarmonyOS Next系统（截止目前API12）的技术细节，基于实际开发实践进行总结。
主要作为技术分享与交流载体，难免错漏，欢迎各位同仁提出宝贵意见和问题，以便共同进步。
本文为原创内容，任何形式的转载必须注明出处及原作者。

在某些场景下，我们希望应用能够精准控制目标应用，例如打开地图应用查看特定地点，或者打开音乐 App 播放特定歌曲。HarmonyOS 提供了多种方式来实现这种类型的跳转，例如 openLink 接口、startAbility 接口和 Web 组件跳转等。

指定应用链接跳转

1. openLink 接口
openLink 接口是最常用的跳转方式，它可以将用户引导到目标应用的特定页面。例如，你可以在购物 App 中点击“查看地图”按钮，然后系统就会自动打开地图 App 并跳转到店铺位置。
openLink 接口参数说明

import { common } from '@ohos.app.ability.common';
export default class EntryAbility extends common.UIAbility {
  onWindowStageCreate(windowStage: common.WindowStage) {
    const context = this.getContext(this) as common.UIAbilityContext;
    const link: string = "geo:37.7749,-122.4194"; // 地点坐标
    const options: common.OpenLinkOptions = {
      appLinkingOnly: false // 允许使用 Deep Linking 跳转
    };
    context.openLink(link, options);
  }
}

2. startAbility 接口
startAbility 接口与 openLink 接口类似，但它提供了更多的选项参数，例如 abilityName 和 moduleName 等，可以指定目标应用的 Ability 名称和模块名称。
startAbility 接口参数说明

import { common } from '@ohos.app.ability.common';
export default class EntryAbility extends common.UIAbility {
  onWindowStageCreate(windowStage: common.WindowStage) {
    const context = this.getContext(this) as common.UIAbilityContext;
    const want: common.Want = {
      action: 'ohos.want.action.viewData',
      uri: "geo:37.7749,-122.4194",
      entities: ["entity.system.browsable"],
      actions: ["ohos.want.action.viewData"]
    };
    context.startAbility(want);
  }
}

3. Web 组件跳转
Web 组件可以通过拦截 onLoadIntercept 回调来处理 Deep Linking 链接，实现应用跳转。
示例代码：

import { webview } from '@ohos.arkweb';
export default class WebComponent {
  controller: webview.WebviewController = new webview.WebviewController();
  build() {
    this.controller.onLoadIntercept((event) => {
      const url: string = event.data.getRequestUrl();
      if (url.startsWith("geo:")) {
        // 跳转到地图应用
      }
      return true; // 阻止页面加载
    });
  }
}

4. 指定 Ability 跳转 (API 11 及以前版本)
在 API 11 及以前版本，可以使用显式 Want 拉起其他应用，但这种方式在 API 12 及以上版本已不再支持。
示例代码：

import { common } from '@ohos.app.ability.common';
export default class EntryAbility extends common.UIAbility {
  onWindowStageCreate(windowStage: common.WindowStage) {
    const context = this.getContext(this) as common.UIAbilityContext;
    const want: common.Want = {
      bundleName: "com.example.demo",
      moduleName: "entry",
      abilityName: "EntryAbility"
    };
    context.startAbility(want);
  }
}

举（N）个栗子

示例 1：使用 openLink 接口打开浏览器

import { common } from '@ohos.app.ability.common';
export default class EntryAbility extends common.UIAbility {
  onWindowStageCreate(windowStage: common.WindowStage) {
    const context = this.getContext(this) as common.UIAbilityContext;
    const link: string = "https://www.example.com";
    const options: common.OpenLinkOptions = {
      appLinkingOnly: false // 允许使用 Deep Linking 跳转
    };
    context.openLink(link, options);
  }
}

示例 2：使用 startAbility 接口打开计算器应用

import { common } from '@ohos.app.ability.common';
export default class EntryAbility extends common.UIAbility {
  onWindowStageCreate(windowStage: common.WindowStage) {
    const context = this.getContext(this) as common.UIAbilityContext;
    const want: common.Want = {
      action: 'ohos.want.action.viewData',
      uri: "calculator",
      entities: ["entity.system.browsable"],
      actions: ["ohos.want.action.viewData"]
    };
    context.startAbility(want);
  }
}

示例 3：使用 Web 组件打开天气应用

import { webview } from '@ohos.arkweb';
export default class WebComponent {
  controller: webview.WebviewController = new webview.WebviewController();
  build() {
    this.controller.onLoadIntercept((event) => {
      const url: string = event.data.getRequestUrl();
      if (url.startsWith("weather:")) {
        // 跳转到天气应用
      }
      return true; // 阻止页面加载
    });
  }
}

总结：
拉起指定应用是应用间跳转的重要方式，它能够精准控制目标应用，实现特定的功能，实际开发中可以根据实际需求选择合适的跳转方式。