文档中心

从API 12开始，已不再推荐三方应用使用指定Ability方式（即显式Want）拉起其他应用，推荐通过指定应用链接的方式来实现。

本章节介绍如何从显式Want跳转切换到应用链接跳转。

说明

暂不支持显式Want中flag字段的转换。如需使用flag字段，建议仍采用显式Want跳转的方式。

启动其他应用的UIAbility

将待跳转的应用安装到设备，在其对应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代表开启域名检查，通过App Linking匹配该应用时需经过配置的域名校验后才能匹配到。

{
  "module": {
    // ···
    "abilities": [
    // ···
      {
        // ···
        "skills": [
          {
            "entities": [
              "entity.system.browsable"
            ],
            "actions": [
              "ohos.want.action.viewData"
            ],
            "uris": [
              {
                "scheme": "https",
                "host": "www.example.com"
              }
            ],
            "domainVerify": true
          }
        ]
      },
    // ···
    ],
    // ···
  }
}

module.json5

调用方通过openLink()接口执行跳转，需要传入link和options，不再需要传入bundleName、moduleName和abilityName。系统会根据传入的link匹配到符合skills配置的应用。

当options中的appLinkingOnly为true时，匹配到的应用会经过应用市场域名检查（需联网）返回域名校验检查的唯一匹配项或未匹配结果。
当options中的appLinkingOnly为false时，会优先尝试以App Linking的方式拉起，如果没有匹配的应用则跳转默认浏览器打开网页。

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 WantAbilityPage1 {
  build() {
    Button('start link', { type: ButtonType.Capsule, stateEffect: true })
      .width('87%')
      .height('5%')
      .margin({ bottom: '12vp' })
      .onClick(() => {
        let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
        /*
         * 通过startAbility接口显式启动其他UIAbility，推荐使用openLink接口。
         * 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选项是否需要通过App Linking域名校验，匹配到唯一配置过的应用ability
          appLinkingOnly: true,
          // 同want中的parameter，用于传递的参数
          parameters: {demoKey: 'demoValue'}
        };

        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}`);
        }
      })
  }
}

WantAbilityPage1.ets

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

将待跳转的应用安装到设备，在其对应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代表开启域名检查，通过App Linking匹配该应用时需经过配置的域名校验后才能匹配到。

{
  "module": {
    // ···
    "abilities": [
    // ···
      {
        // ···
        "skills": [
          {
            "entities": [
              "entity.system.browsable"
            ],
            "actions": [
              "ohos.want.action.viewData"
            ],
            "uris": [
              {
                "scheme": "https",
                "host": "www.example.com"
              }
            ],
            "domainVerify": true
          }
        ]
      },
    // ···
    ],
    // ···
  }
}

module.json5

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

当options中的appLinkingOnly为true时，匹配到的应用会经过应用市场域名检查（需联网）返回域名校验检查的唯一匹配项或未匹配结果。
当options中的appLinkingOnly为false时，会优先尝试以App Linking的方式拉起，如果没有匹配的应用则跳转默认浏览器打开网页。

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 WantAbilityPage2 {
  build() {
    Button('start link', { type: ButtonType.Capsule, stateEffect: true })
      .width('87%')
      .height('5%')
      .margin({ bottom: '12vp' })
      .onClick(() => {
        let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
        /*
         * 通过startAbility接口显式启动其他UIAbility，推荐使用openLink接口。
         * 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选项是否需要通过App Linking域名校验，匹配到唯一配置过的应用ability
          appLinkingOnly: true,
          // 同want中的parameter，用于传递的参数
          parameters: {demoKey: 'demoValue'}
        };

        try {
          context.openLink(link, openLinkOptions, (err, data) => {
            // AbilityResult回调函数，仅在被启动的UIAbility终止时触发
            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}`);
        }
      })
  }
}

WantAbilityPage2.ets

显式Want跳转切换应用链接跳转适配指导

启动其他应用的UIAbility

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