顯式Want與隱式Want匹配規則

在啟動目標應用組件時，會通過顯式[Want]或者隱式[Want]進行目標應用組件的匹配，這里說的匹配規則就是調用方傳入的[want]參數中設置的參數如何與目標應用組件聲明的配置文件進行匹配。

顯式Want匹配原理

顯式[Want]匹配原理如下表所示。

隱式Want匹配原理

隱式[Want]匹配原理如下表所示。

從隱式Want的定義，可得知：

• 調用方傳入的want參數，表明調用方需要執行的操作，并提供相關數據以及其他應用類型限制。
• 待匹配應用組件的skills配置，聲明其具備的能力（[module.json5配置文件]參數）。

系統將調用方傳入的want參數（包含action、entities、uri和type屬性）與已安裝待匹配應用組件的skills配置（包含actions、entities、uris和type屬性）依次進行匹配。當四個屬性匹配均未配置，隱式匹配失敗。當四個屬性匹配均通過，則此應用才會被應用選擇器展示給用戶進行選擇。

want參數的action匹配規則

將調用方傳入的want參數的action與待匹配應用組件的skills配置中的actions進行匹配。

• 調用方傳入的want參數的action為空，待匹配Ability的skills配置中的actions為空，則action匹配失敗。
• 調用方傳入的want參數的action不為空，待匹配應用組件的skills配置中的actions為空，則action匹配失敗。
• 調用方傳入的want參數的action為空，待匹配應用組件的skills配置中的actions不為空，則action匹配成功。
• 調用方傳入的want參數的action不為空，待匹配應用組件的skills配置中的actions不為空且包含調用方傳入的want參數的action，則action匹配成功。
• 調用方傳入的want參數的action不為空，待匹配應用組件的skills配置中的actions不為空且不包含調用方傳入的want參數的action，則action匹配失敗。
  圖1 want參數的action匹配規則

want參數的entities匹配規則

將調用方傳入的want參數的entities與待匹配應用組件的skills配置中的entities進行匹配。

• 調用方傳入的want參數的entities為空，待匹配應用組件的skills配置中的entities不為空，則entities匹配成功。
• 調用方傳入的want參數的entities為空，待匹配應用組件的skills配置中的entities為空，則entities匹配成功。
• 調用方傳入的want參數的entities不為空，待匹配應用組件的skills配置中的entities為空，則entities匹配失敗。
• 調用方傳入的want參數的entities不為空，待匹配應用組件的skills配置中的entities不為空且包含調用方傳入的want參數的entities，則entities匹配成功。
• 調用方傳入的want參數的entities不為空，待匹配應用組件的skills配置中的entities不為空且不完全包含調用方傳入的want參數的entities，則entities匹配失敗。
  圖2 want參數的entities匹配規則

want參數的uri和type匹配規則

調用方傳入的want參數中設置uri和type參數發起啟動應用組件的請求，系統會遍歷當前系統已安裝的組件列表，并逐個匹配待匹配應用組件的skills配置中的uris數組，如果待匹配應用組件的skills配置中的uris數組中只要有一個可以匹配調用方傳入的want參數中設置的uri和type即為匹配成功。

實際應用中，uri和type共存在四種情況，下面將講解四種情況的具體匹配規則：

• 調用方傳入的want參數的uri和type都為空。
  1. 如果待匹配應用組件的skills配置中的uris數組為空，匹配成功。
  2. 如果待匹配應用組件的skills配置中的uris數組中存在uri的scheme和type都為空的元素，匹配成功。
  3. 除以上兩種情況，其他情況均為匹配失敗。
• 調用方傳入的want參數的uri不為空，type為空。
  1. 如果待匹配應用組件的skills配置中的uris數組為空，匹配失敗。
  2. 如果待匹配應用組件的skills配置中的uris數組存在一條數據[uri匹配]成功且type為空，則匹配成功，否則匹配失敗。
  3. 如果前兩條均匹配失敗，并且傳入的uri為文件路徑uri，則根據文件后綴獲取文件的MIME類型，如果該類型與skills文件中配置的type相匹配，則匹配成功。
• 調用方傳入的want參數的uri為空，type不為空。
  1. 如果待匹配應用組件的skills配置中的uris數組為空，匹配失敗。
  2. 如果待匹配應用組件的skills配置中的uris數組存在一條數據uri的scheme為空且[type匹配]成功，則匹配成功，否則匹配失敗。
• 調用方傳入的want參數的uri和type都不為空，如下圖所示。
  1. 如果待匹配應用組件的skills配置中的uris數組為空，匹配失敗。
  2. 如果待匹配應用組件的skills配置中的uris數組存在一條數據[uri匹配]和[type匹配]需要均匹配成功，則匹配成功，否則匹配失敗。

最左uri匹配：當配置文件待匹配應用組件的skills配置中的uris數組中只配置scheme；或者只配置scheme和host；或者只配置scheme、host和port時。傳入want參數的uri的最左邊依次需要和scheme，或者scheme和host，或者scheme、host和port都匹配，才滿足最左uri匹配。

圖3 want參數中uri和type皆不為空時的匹配規則

為了簡化描述：

• 稱調用方傳入的want參數中的uri參數為w_uri；待匹配應用組件的skills配置中uri為s_uri，其中每個元素為s_uri。
• 稱調用方傳入的want參數的type參數為w_type，待匹配應用組件的skills數組中uris的type數據為s_type。

圖4 want參數中uri和type的具體匹配規則

uri匹配規則

具體的匹配規則如下：

• 如果s_uri的scheme為空，當w_uri為空時匹配成功，否則匹配失敗。
• 如果s_uri的host為空，當w_uri和s_uri的scheme相同時匹配成功，否則匹配失敗。
• 如果s_uri的port為空，當w_uri和s_uri中的scheme和host相同時匹配成功，否則匹配失敗。
• 如果s_uri的path、pathStartWith和pathRegex都為空，當w_uri和s_uri中的scheme，host和port相同時匹配成功，否則匹配失敗。
• 如果s_uri的path不為空，當w_uri和s_uri全路徑表達式相同時匹配成功，否則繼續進行pathStartWith的匹配。
• 如果s_uri的pathStartWith不為空，當w_uri包含s_uri前綴表達式時匹配成功，否則繼續進行pathRegex的匹配。
• 如果s_uri的pathRegex不為空，當w_uri滿足s_uri正則表達式時匹配成功，否則匹配失敗。

說明：

待匹配應用組件的skills配置的uris中scheme、host、port、path、pathStartWith和pathRegex屬性拼接，如果依次聲明了path、pathStartWith和pathRegex屬性時，uris將分別拼接為如下三種表達式：

• 前綴uri表達式 ：當配置文件只配置scheme，或者只配置scheme和host，或者只配置scheme，host和port時，參數傳入以配置文件為前綴的Uri
  • scheme://
  • scheme://host
  • scheme://host:port
• 全路徑表達式 ：scheme://host:port/path
• 前綴表達式 ：scheme://host:port/pathStartWith
• 正則表達式 ：scheme://host:port/pathRegex

系統應用預留uri的scheme統一以ohos開頭，例如ohosclock://。三方應用組件配置的uri不能與系統應用重復，否則會導致無法通過該uri拉起三方應用組件。

type匹配規則

說明：

本章節所述的type匹配規則的適用性需建立在want參數內type不為空的基礎上。當want參數內type為空時請參見[want參數的uri和type匹配規則]。

具體的匹配規則如下：

• 如果s_type為空，則匹配失敗。
• 如果s_type或者w_type為通配符*/*，則匹配成功。
• 如果s_type最后一個字符為通配符*，如prefixType/*，則當w_type包含prefixType/時匹配成功，否則匹配失敗。
• 如果w_type最后一個字符為通配符*，如prefixType/*，則當s_type包含prefixType/時匹配成功，否則匹配失敗。

審核編輯 黃宇