建立應用程式內容的深層連結

當點選的連結或程式輔助要求叫用網路 URI 意圖時,Android 系統會依序嘗試下列每個動作,直到要求成功:

  1. 開啟使用者的偏好應用程式,以便處理 URI (如有指定)。
  2. 開啟唯一可處理 URI 的應用程式。
  3. 允許使用者從對話方塊選取應用程式。

請按照下列步驟建立並測試你的內容連結。您也可以使用 Android Studio 中的應用程式連結小幫手來新增 Android 應用程式連結。

注意: 自 Android 12 (API 級別 31) 起,只有在應用程式獲準用於網路意圖中的特定網域時,一般網路意圖才能解析至應用程式內的活動。如果應用程式未獲網域核准,網路意圖會改為將使用者的預設瀏覽器應用程式解析為使用者的預設瀏覽器應用程式。

為連入連結新增意圖篩選器

如要建立應用程式內容連結,請在資訊清單中新增包含這些元素和屬性值的意圖篩選器:

<action>
指定 ACTION_VIEW 意圖動作,以便透過 Google 搜尋觸及意圖篩選器。
<data>
新增一或多個 <data> 標記,每個標記都代表可解析活動的 URI 格式。<data> 標記至少必須包含 android:scheme 屬性。

您可以新增更多屬性,進一步修正活動接受的 URI 類型。例如,您可能有多項活動接受類似 URI,但這些活動僅根據路徑名稱而不同。在這種情況下,請使用 android:path 屬性或其 pathPatternpathPrefix 變體,以區分系統應該為不同的 URI 路徑開啟哪個活動。

<category>
加入 BROWSABLE 類別。需要透過網路瀏覽器存取意圖篩選器。如果沒有該連結,按下瀏覽器中的連結將無法解析您的應用程式。

請一併加入 DEFAULT 類別。 如此一來,應用程式就能回應隱含意圖。如果沒有這種情況,只有在意圖指定應用程式元件名稱時,才能啟動活動。

下列 XML 程式碼片段說明如何在資訊清單中為深層連結指定意圖篩選器。URI “example://gizmos”“http://www.example.com/gizmos” 都會解析為這個活動。

<activity
    android:name="com.example.android.GizmosActivity"
    android:label="@string/title_gizmos" >
    <intent-filter android:label="@string/filter_view_http_gizmos">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- Accepts URIs that begin with "http://www.example.com/gizmos” -->
        <data android:scheme="http"
              android:host="www.example.com"
              android:pathPrefix="/gizmos" />
        <!-- note that the leading "/" is required for pathPrefix-->
    </intent-filter>
    <intent-filter android:label="@string/filter_view_example_gizmos">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- Accepts URIs that begin with "example://gizmos” -->
        <data android:scheme="example"
              android:host="gizmos" />
    </intent-filter>
</activity>

請注意,這兩個意圖篩選器只有 <data> 元素不同。雖然您可以將多個 <data> 元素放在同一個篩選器中,但當您意圖宣告不重複網址 (例如 schemehost 的特定組合) 時,請務必分別建立篩選器,因為系統實際上會合併同一個意圖篩選器中的多個 <data> 元素,以涵蓋其合併屬性的所有變化版本。舉例來說,您可以考慮:

<intent-filter>
  ...
  <data android:scheme="https" android:host="www.example.com" />
  <data android:scheme="app" android:host="open.my.app" />
</intent-filter>

它似乎僅支援 https://www.example.comapp://open.my.app。不過,它實際上支援這兩個類型,並加上以下元素:app://www.example.comhttps://open.my.app

注意:如果多個活動包含的意圖篩選器會解析為同一個已驗證的 Android 應用程式連結,則無法保證哪些活動會處理該連結。

將活動內容的 URI 加入意圖篩選器後,Android 就能在執行階段將任何具有相符 URI 的 Intent 轉送到應用程式。

如要進一步瞭解如何定義意圖篩選器,請參閱「允許其他應用程式啟動您的活動」。

讀取傳入意圖中的資料

系統透過意圖篩選器啟動活動後,您就可以使用 Intent 提供的資料來判斷需要轉譯的內容。呼叫 getData()getAction() 方法,擷取與傳入 Intent 相關聯的資料和動作。在活動生命週期中,您隨時可以呼叫這些方法,但一般而言,應在 onCreate()onStart() 等早期回呼期間進行呼叫。

以下程式碼片段說明如何從 Intent 擷取資料:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)

    val action: String? = intent?.action
    val data: Uri? = intent?.data
}

Java

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

    Intent intent = getIntent();
    String action = intent.getAction();
    Uri data = intent.getData();
}

只要遵循下列最佳做法,即可改善使用者體驗:

  • 深層連結應直接將使用者導向內容,讓使用者略過提示訊息、插頁或登入程序。請確認使用者即使未曾開啟應用程式,也能查看應用程式內容。不過,當使用者進行後續互動,或從啟動器中開啟應用程式時,您就可以發送提示訊息。
  • 請遵循「使用返回和向上導覽功能」中所述的設計指南,讓使用者在透過深層連結進入應用程式後,應用程式會滿足返回瀏覽的預期。

測試深層連結

您可以搭配使用 Android 偵錯橋接器與活動管理員 (am) 工具,測試您為深層連結指定的意圖篩選器 URI 是否能解析至正確的應用程式活動。您可以在裝置或模擬器上執行 ADB 指令。

使用 ADB 測試意圖篩選器 URI 的一般語法如下:

$ adb shell am start
        -W -a android.intent.action.VIEW
        -d <URI> <PACKAGE>

舉例來說,以下指令會嘗試查看與指定 URI 相關聯的目標應用程式活動。

$ adb shell am start
        -W -a android.intent.action.VIEW
        -d "example://gizmos" com.example.android

您在上方設定的資訊清單宣告和意圖處理常式會定義應用程式和網站之間的連線,以及如何處理傳入連結。不過,為了讓系統將應用程式視為一組 URI 的預設處理常式,您還必須要求系統驗證這項連線。下一堂課程將說明如何實作這項驗證程序。

如要進一步瞭解意圖和應用程式連結,請參閱下列資源: