We use essential cookies for the website to function, as well as analytics cookies for analyzing and creating statistics of the website performance. To agree to the use of analytics cookies, click "Accept All". You can manage your preferences at any time by clicking "Cookie Settings" on the footer. More Information.

Cookie Settings
Only Essential Cookies
Accept All
MaterialsConsole

HarmonyOS

输入关键字搜索
HMS Core
AppGallery Connect
HUAWEI HiAI
CTRL+K

Switching from Explicit Want Redirection to Linking Redirection

Last updated: 2026-10-15 01:23
Content overview

Starting from API version 12, it is not recommended that third-party applications start other applications by specifying an ability (implicit Want mode). Instead, the linking mode is recommended.

This section describes how to switch from explicit Want mode to linking mode.

Starting the UIAbility of Another Application

  1. Install the application on your device. In the module.json5 file of the UIAbility, configure entities, actions, and uri under skills.

    • The actions field must contain ohos.want.action.viewData.
    • The entities field must contain entity.system.browsable.
    • The uris field must contain an element whose scheme is https. domainVerify must be set to true. For details about the URI matching rules, see Matching Rules of uri. If domainVerify is set to true, domain name verification is enabled. In this case, the target application must pass domain name verification during App Linking.
    Collapse
    Word wrap
    Dark theme
    Copy code
    1. {
    2.   "module": {
    3.     // ···
    4.     "abilities": [
    5.     // ···
    6.       {
    7.         // ···
    8.         "skills": [
    9.           {
    10.             "entities": [
    11.               "entity.system.browsable"
    12.             ],
    13.             "actions": [
    14.               "ohos.want.action.viewData"
    15.             ],
    16.             "uris": [
    17.               {
    18.                 "scheme": "https",
    19.                 "host": "www.example.com"
    20.               }
    21.             ],
    22.             "domainVerify": true
    23.           }
    24.         ]
    25.       },
    26.     // ···
    27.     ],
    28.     // ···
    29.   }
    30. }
    module.json5

  2. Call openLink to trigger redirection. The link and options must be passed in, but the bundle name, module name, and ability name are not required. The system matches the application that meets the skills configuration based on the link.

    • If appLinkingOnly in options is set to true, the target application must pass domain name verification (Internet connection required). A unique matching item or an unmatched result will be returned.
    • If appLinkingOnly in options is set to false, the system preferentially attempts to start the target application in App Linking mode. If no matching application is found, the system starts the application in Deep Linking mode.
    Collapse
    Word wrap
    Dark theme
    Copy code
    1. import { common, OpenLinkOptions } from '@kit.AbilityKit';
    2. import { BusinessError } from '@kit.BasicServicesKit';
    3. import { hilog } from '@kit.PerformanceAnalysisKit';
    4. 

    5. const TAG: string = '[UIAbilityComponentsOpenLink]';
    6. const DOMAIN_NUMBER: number = 0xFF00;
    7. 

    8. @Entry
    9. @Component
    10. struct WantAbilityPage1 {
    11.   build() {
    12.     Button('start link', { type: ButtonType.Capsule, stateEffect: true })
    13.       .width('87%')
    14.       .height('5%')
    15.       .margin({ bottom: '12vp' })
    16.       .onClick(() => {
    17.         let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    18.         // When using startAbility to explicitly start other UIAbilities, the openLink API is recommended.
    19.         // let want: Want = {
    20.         //   bundleName: "com.test.example",
    21.         //   moduleName: "entry",
    22.         //   abilityName: "EntryAbility"
    23.         // };
    24.         // try {
    25.         //   context.startAbility(want)
    26.         //     .then(() => {
    27.         //       hilog.info(DOMAIN_NUMBER, TAG, 'startAbility success.');
    28.         //     }).catch((err: BusinessError) => {
    29.         //       hilog.error(DOMAIN_NUMBER, TAG, `startAbility failed. Code is ${err.code}, message is ${err.message}`);
    30.         //     })
    31.         // } catch (paramError) {
    32.         //   hilog.error(DOMAIN_NUMBER, TAG, `Failed to startAbility. Code is ${paramError.code},\
    33.         //   message is ${paramError.message}`);
    34.         // }
    35.         let link: string = 'https://www.example.com';
    36.         let openLinkOptions: OpenLinkOptions = {
    37.           // Specify whether the matched abilities options must pass App Linking domain name verification.
    38.           appLinkingOnly: true,
    39.           // Same as parameter in want, which is used to transfer parameters.
    40.           parameters: {demo_key: 'demo_value'}
    41.         };
    42. 

    43.         try {
    44.           context.openLink(link, openLinkOptions)
    45.             .then(() => {
    46.               hilog.info(DOMAIN_NUMBER, TAG, 'open link success.');
    47.             }).catch((err: BusinessError) => {
    48.             hilog.error(DOMAIN_NUMBER, TAG, `open link failed. Code is ${err.code}, message is ${err.message}`);
    49.           })
    50.         } catch (paramError) {
    51.           hilog.error(DOMAIN_NUMBER, TAG, `Failed to start link. Code is ${paramError.code}, message is ${paramError.message}`);
    52.         }
    53.       })
    54.   }
    55. }
    WantAbilityPage1.ets

Starting the UIAbility of Another Application and Obtaining the Return Result

  1. Install the application on your device. In the module.json5 file of the UIAbility, configure entities, actions, and uri under skills.

    • The actions field must contain ohos.want.action.viewData.
    • The entities field must contain entity.system.browsable.
    • The uris field must contain an element whose scheme is https. domainVerify must be set to true. For details about the URI matching rules, see Matching Rules of uri. If domainVerify is set to true, domain name verification is enabled. In this case, the target application must pass domain name verification during App Linking.
    Collapse
    Word wrap
    Dark theme
    Copy code
    1. {
    2.   "module": {
    3.     // ···
    4.     "abilities": [
    5.     // ···
    6.       {
    7.         // ···
    8.         "skills": [
    9.           {
    10.             "entities": [
    11.               "entity.system.browsable"
    12.             ],
    13.             "actions": [
    14.               "ohos.want.action.viewData"
    15.             ],
    16.             "uris": [
    17.               {
    18.                 "scheme": "https",
    19.                 "host": "www.example.com"
    20.               }
    21.             ],
    22.             "domainVerify": true
    23.           }
    24.         ]
    25.       },
    26.     // ···
    27.     ],
    28.     // ···
    29.   }
    30. }
    module.json5

  2. Call openLink to trigger redirection. The link and options must be passed in, but the bundle name, module name, and ability name are not required. The system matches the application that meets the skills configuration based on the link. AbilityResult is transferred to the callback function through input parameters and returned to the caller application when the UIAbility is terminated. The startup success or failure result is returned through a promise.

    • If appLinkingOnly in options is set to true, the target application must pass domain name verification (Internet connection required). A unique matching item or an unmatched result will be returned.
    • If appLinkingOnly in options is set to false, the system preferentially attempts to start the target application in App Linking mode. If no matching application is found, the system starts the application in Deep Linking mode.
    Collapse
    Word wrap
    Dark theme
    Copy code
    1. import { common, OpenLinkOptions } from '@kit.AbilityKit';
    2. import { BusinessError } from '@kit.BasicServicesKit';
    3. import { hilog } from '@kit.PerformanceAnalysisKit';
    4. 

    5. const TAG: string = '[UIAbilityComponentsOpenLink]';
    6. const DOMAIN_NUMBER: number = 0xFF00;
    7. 

    8. @Entry
    9. @Component
    10. struct WantAbilityPage2 {
    11.   build() {
    12.     Button('start link', { type: ButtonType.Capsule, stateEffect: true })
    13.       .width('87%')
    14.       .height('5%')
    15.       .margin({ bottom: '12vp' })
    16.       .onClick(() => {
    17.         let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    18.         // When using startAbility to explicitly start other UIAbilities, the openLink API is recommended.
    19.         // let want: Want = {
    20.         //   bundleName: "com.test.example",
    21.         //   moduleName: "entry",
    22.         //   abilityName: "EntryAbility"
    23.         // };
    24.         // try {
    25.         //   context.startAbilityForResult(want)
    26.         //     .then((data) => {
    27.         //       hilog.info(DOMAIN_NUMBER, TAG, 'startAbility success. data: ' + JSON.stringify(data));
    28.         //     }).catch((err: BusinessError) => {
    29.         //       hilog.error(DOMAIN_NUMBER, TAG, `startAbility failed. Code is ${err.code}, message is ${err.message}`);
    30.         //     })
    31.         // } catch (paramError) {
    32.         //   hilog.error(DOMAIN_NUMBER, TAG, `Failed to startAbility. Code is ${paramError.code}, \
    33.         //   message is ${paramError.message}`);
    34.         // }
    35.         let link: string = 'https://www.example.com';
    36.         let openLinkOptions: OpenLinkOptions = {
    37.           // Specify whether the matched abilities options must pass App Linking domain name verification.
    38.           appLinkingOnly: true,
    39.           // Same as parameter in want, which is used to transfer parameters.
    40.           parameters: {demo_key: 'demo_value'}
    41.         };
    42. 

    43.         try {
    44.           context.openLink(link, openLinkOptions, (err, data) => {
    45.             // AbilityResult callback function, which is triggered only when the started UIAbility is terminated.
    46.             hilog.info(DOMAIN_NUMBER, TAG, 'open link success. Callback result: ' + JSON.stringify(data));
    47.           }).then(() => {
    48.             hilog.info(DOMAIN_NUMBER, TAG, 'open link success.');
    49.           }).catch((err: BusinessError) => {
    50.             hilog.error(DOMAIN_NUMBER, TAG, `open link failed. Code is ${err.code}, message is ${err.message}`);
    51.           })
    52.         } catch (paramError) {
    53.           hilog.error(DOMAIN_NUMBER, TAG, `Failed to start link. Code is ${paramError.code}, message is ${paramError.message}`);
    54.         }
    55.       })
    56.   }
    57. }
    WantAbilityPage2.ets
English
©2026 HUAWEI Developers. All rights reserved.
Terms of Use
Statement About HUAWEI Developers and Privacy
Cookies
Cookie Settings
Open-Source Software Notice