Want概述

Want的定義與用途

[Want]是一種對象，用于在應(yīng)用組件之間傳遞信息。

其中，一種常見的使用場景是作為[startAbility()]方法的參數(shù)。例如，當(dāng)UIAbilityA需要啟動UIAbilityB并向UIAbilityB傳遞一些數(shù)據(jù)時，可以使用Want作為一個載體，將數(shù)據(jù)傳遞給UIAbilityB。

圖1 Want用法示意

Want的類型

• 顯式Want ：在啟動目標(biāo)應(yīng)用組件時，調(diào)用方傳入的want參數(shù)中指定了abilityName和bundleName，稱為顯式Want。
  顯式Want通常用于應(yīng)用內(nèi)組件啟動，通過在Want對象內(nèi)指定本應(yīng)用Bundle名稱信息（bundleName）和abilityName來啟動應(yīng)用內(nèi)目標(biāo)組件。當(dāng)有明確處理請求的對象時，顯式Want是一種簡單有效的啟動目標(biāo)應(yīng)用組件的方式。

  說明：

  API 11及以前版本，支持使用顯式want拉起其他應(yīng)用的UIAbility。 從API 12開始，不再支持使用顯式Want進(jìn)行應(yīng)用間跳轉(zhuǎn)，需要通過openLink接口拉起其他應(yīng)用。

  import { Want } from '@kit.AbilityKit';
  
  let wantInfo: Want = {
    deviceId: '', // deviceId為空表示本設(shè)備
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
  }
  

• 隱式Want ：在啟動目標(biāo)應(yīng)用組件時，調(diào)用方傳入的want參數(shù)中未指定abilityName，稱為隱式Want。
  當(dāng)需要處理的對象不明確時，可以使用隱式Want，在當(dāng)前應(yīng)用中使用其他應(yīng)用提供的某個能力，而不關(guān)心提供該能力的具體應(yīng)用。隱式Want使用[skills標(biāo)簽]來定義需要使用的能力，并由系統(tǒng)匹配聲明支持該請求的所有應(yīng)用來處理請求。例如，需要打開一個鏈接的請求，系統(tǒng)將匹配所有聲明支持該請求的應(yīng)用，然后讓用戶選擇使用哪個應(yīng)用打開鏈接。

  import { Want } from '@kit.AbilityKit';
  
  let wantInfo: Want = {
    // uncomment line below if wish to implicitly query only in the specific bundle.
    // bundleName: 'com.example.myapplication',
    action: 'ohos.want.action.search',
    // entities can be omitted
    entities: [ 'entity.system.browsable' ],
    uri: 'https://www.test.com:8080/query/student',
    type: 'text/plain',
  };
  

  

  說明：
  開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

  • 根據(jù)系統(tǒng)中待匹配應(yīng)用組件的匹配情況不同，使用隱式Want啟動應(yīng)用組件時會出現(xiàn)以下三種情況。
    • 未匹配到滿足條件的應(yīng)用組件：啟動失敗。
    • 匹配到一個滿足條件的應(yīng)用組件：直接啟動該應(yīng)用組件。
    • 匹配到多個滿足條件的應(yīng)用組件（UIAbility）：彈出選擇框讓用戶選擇。
  • 對于啟動ServiceExtensionAbility的場景：
    • 調(diào)用方傳入的want參數(shù)中帶有abilityName，則不允許通過隱式Want啟動ServiceExtensionAbility。
    • 調(diào)用方傳入的want參數(shù)中帶有bundleName，則允許使用startServiceExtensionAbility()方法隱式Want啟動ServiceExtensionAbility，默認(rèn)返回優(yōu)先級最高的ServiceExtensionAbility，如果優(yōu)先級相同，返回第一個。

審核編輯 黃宇