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

當使用者點選連結或程式輔助要求叫用網頁 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，但這些 URI 只是路徑名稱不同。在這種情況下，請使用 android:path 屬性或其 pathPattern 或 pathPrefix 變體，區分系統應為不同 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> 元素，但如果打算宣告專屬網址 (例如 scheme 和 host 的特定組合)，請務必建立個別篩選器，因為同一個意圖篩選器中的多個 <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.com 和 app://open.my.app。不過，除了這兩個，它還支援以下項目： app://www.example.com 和 https://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 的預設處理常式，您也必須要求系統驗證這項連結。下一堂課將說明如何實作這項驗證。

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