# Jump2App

**Repository Path**: scenario-samples/jump2-app

## Basic Information

- **Project Name**: Jump2App
- **Description**: 应用间跳转是各类应用的高频使用场景之一，如跳转华为地图、跳转华为音乐等。

本示例基于Deep Linking实现应用间跳转。使用canOpenLink判断目标URL Scheme对应应用是否可以访问，可以访问则通过openLink拉起目标应用。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2026-02-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 跳转常见三方应用的示例

## 场景介绍
应用间跳转是各类应用的高频使用场景之一，如跳转华为地图、跳转华为音乐等。

本示例基于[Deep Linking](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/deep-linking-startup)实现应用间跳转。使用[canOpenLink](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundlemanagercanopenlink12)判断目标URL Scheme对应应用是否可以访问，可以访问则通过[openLink](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-uiabilitycontext#openlink12)拉起目标应用。

## 效果预览
<img src="./screenshots/jump2App.gif" width="200" />

## 实现思路
1.在entry模块的[module.json5文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)中配置querySchemes属性，声明想要查询的URL Scheme。
```json5
{
  "module": {
    // 添加需要访问的schemes
    "querySchemes": [
      // 华为地图
      'maps',
      // 华为音乐
      'hwmusic',
      // 华为视频
      'himovie',
      // 我的华为
      'myhuawei',
      // 运动健康
      'huaweischeme',
      // ...
    ]
  }
}
```

2.使用[bundleManager.canOpenLink](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundlemanagercanopenlink12)判断目标URL Scheme对应应用是否可以访问，可以访问则通过[UIAbilityContext.openLink](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-uiabilitycontext#openlink12)拉起目标应用。
```typescript
// 使用canOpenLink判断是否可以访问
let data = bundleManager.canOpenLink(deepLink);
if (data) {
  // 使用openLink打开应用
  this.context.openLink(deepLink, { appLinkingOnly: false })
    .then(() => {
      // 正常跳转
      // ...
    })
    .catch((error: BusinessError) => {
      // 跳转失败
      // ...
    });
} else {
  // 该URL Scheme无法访问
  // ...
}
```

> 常见三方应用Deep Linking的URL Scheme可参考下表：
> 
> | 应用名 | scheme | 示例 |
> | - | - | - |
> | 华为地图 | maps | maps://home |
> | 华为音乐 | hwmusic | hwmusic://com.huawei.hmsapp.music |
> | 华为视频 | himovie | himovie://com.huawei.hmsapp.himovie |
> | 我的华为 | myhuawei | myhuawei://dispatch |
> | 运动健康 | huaweischeme | huaweischeme://healthapp |
> | 抖音 | snssdk1128 | snssdk1128://home |
> | 微博 | sinaweibo | sinaweibo://home |
> | 小红书 | xhsdiscover | xhsdiscover://home |
> | 哔哩哔哩 | bilibili | bilibili://home |
> | 快手 | kwai | kwai://home |
> | 微信 | weixin | weixin://home |
> | QQ | mqqapi | mqqapi://home |
> | 支付宝 | alipays | alipays://home |
> | 云闪付 | upwallet | upwallet://home |
> | 京东 | openapp.jdmobile | openapp.jdmobile://home |
> | 美团 | imeituan | imeituan://www.meituan.com |
> | 拼多多 | pinduoduo | pinduoduo://home |
> | 淘宝 | tbopen | tbopen://m.taobao.com/tbopen/index.html |
> | 高德地图 | amapuri | amapuri://home |
> | 腾讯会议 | wemeet | wemeet://home |
> | 知乎 | zhihu | zhihu://home |

## 说明
下拉选择对应应用，点击跳转。

## 约束与限制
* 本示例支持API Version 20 Release及以上版本。
* 本示例支持HarmonyOS 6.0.0 Release SDK及以上版本。
* 本示例需要使用DevEco Studio 6.0.0 Release及以上版本进行编译运行。

## 权限说明
不涉及。

## 工程目录
```
├──entry/src/main/ets                   // 代码区
│  ├──entryability
│  │  └──EntryAbility.ets       
│  ├──entrybackupability
│  │  └──EntryBackupAbility.ets      
│  ├──pages
│  │  ├──MainPage.ets                   // 首页
└──entry/src/main/resources             // 应用资源目录
```

## 参考文档
[使用canOpenLink判断应用是否可访问](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/canopenlink)

[使用openLink实现应用跳转](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/deep-linking-startup#%E4%BD%BF%E7%94%A8openlink%E5%AE%9E%E7%8E%B0%E5%BA%94%E7%94%A8%E8%B7%B3%E8%BD%AC)