输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南
指南应用框架Ability Kit（程序框架服务）应用模型应用组件信息传递载体WantWant概述

Want概述

更新时间: 2026-08-29 09:41
本文导读

Want的定义与用途

Want是一种对象，用于在应用组件之间传递信息。

其中，一种常见的使用场景是作为startAbility()方法的参数。例如，当UIAbilityA需要启动UIAbilityB并向UIAbilityB传递一些数据时，可以使用Want作为一个载体，将数据传递给UIAbilityB。

图1 Want用法示意

Want的类型

  • 显式Want：在启动目标应用组件时，调用方传入的want参数中指定了abilityName和bundleName，称为显式Want。

    显式Want通常用于应用内组件启动，通过在Want对象内指定本应用Bundle名称信息（bundleName）和abilityName来启动应用内目标组件。当有明确处理请求的对象时，显式Want是一种简单有效的启动目标应用组件的方式。

    说明

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

    收起
    自动换行
    深色代码主题
    复制
    1. import { common, Want } from '@kit.AbilityKit';
    2. // ···
    3. 

    4. let wantInfo: Want = {
    5.   deviceId: '', // deviceId为空表示本设备
    6.   bundleName: 'com.samples.wantoverview',
    7.   abilityName: 'ExplicitAbility',
    8. };
    ExplicitPage.ets

  • 隐式Want：在启动目标应用组件时，调用方传入的want参数中未指定abilityName，称为隐式Want。

    当需要处理的对象不明确时，可以使用隐式Want，在当前应用中使用其他应用提供的某个能力，而不关心提供该能力的具体应用。隐式Want使用skills标签来定义需要使用的能力，并由系统匹配声明支持该请求的所有应用来处理请求。例如，需要打开一个链接的请求，系统将匹配所有声明支持该请求的应用，然后让用户选择使用哪个应用打开链接。

    收起
    自动换行
    深色代码主题
    复制
    1. import { common, Want } from '@kit.AbilityKit';
    2. // ···
    3. 

    4. let wantInfo: Want = {
    5.   // uncomment line below if wish to implicitly query only in the specific bundle.
    6.   // bundleName: 'com.example.myapplication',
    7.   action: 'ohos.want.action.search',
    8.   // entities can be omitted
    9.   entities: ['entity.system.browsable'],
    10.   uri: 'https://www.test.com:8080/query/student',
    11.   type: 'text/plain',
    12. };
    ImplicitPage.ets
    说明
    • 根据系统中待匹配应用组件的匹配情况不同，使用隐式Want启动应用组件时会出现以下三种情况。
      • 未匹配到满足条件的应用组件：启动失败。
      • 匹配到一个满足条件的应用组件：直接启动该应用组件。
      • 匹配到多个满足条件的应用组件（UIAbility）：弹出选择框让用户选择。
信息传递载体Want
显式Want与隐式Want匹配规则
相关推荐
文档Want
文档@ohos.application.Want (Want)
文档@ohos.app.ability.Want (Want)
文档want.h
文档使用显式Want启动应用组件
文档显式Want与隐式Want匹配规则
文档want参数解析
文档获取want参数
文档@ohos.app.ability.wantAgent (WantAgent模块)
文档显式Want跳转切换应用链接跳转适配指导
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词