驗證 Android 應用程式連結

Android 應用程式連結是一種特殊的深層連結，可讓網站網址立即開啟 Android 應用程式中的對應內容，使用者不必選取應用程式。Android 應用程式連結會使用 Digital Asset Links API 建立信任關係，確保網站已核准應用程式自動開啟該網域的連結。如果系統成功驗證您擁有這些網址，系統就會自動將這些網址意圖導向您的應用程式。

如要驗證您同時擁有應用程式和網站網址，請完成下列步驟：

  1. 新增意圖篩選器，其中包含 autoVerify 屬性。這個屬性會向系統發出信號，表示系統應驗證您的應用程式是否屬於意圖篩選器中使用的網域。

  2. 在以下位置代管 Digital Asset Links JSON 檔案，宣告網站與意圖篩選器之間的關聯：

    https://domain.name/.well-known/assetlinks.json

如需相關資訊，請參閱下列資源：

新增意圖篩選器，驗證應用程式連結

如要為應用程式啟用連結處理驗證，請新增符合下列格式的意圖篩選器：

<!-- Make sure you explicitly set android:autoVerify to "true". -->
<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <!-- If a user clicks on a shared link that uses the "http" scheme, your
         app should be able to delegate that traffic to "https". -->
    <!-- Do not include other schemes. -->
    <data android:scheme="http" />
    <data android:scheme="https" />

    <!-- Include one or more domains that should be verified. -->
    <data android:host="..." />
</intent-filter>

雖然每個主機的 <intent-filter> 宣告中只要包含一個 autoVerify 就足夠，即使該主機用於其他未標記的宣告也一樣，但建議您為每個 <intent-filter> 元素新增 autoVerify，確保一致性。這也能確保您移除或重構資訊清單檔案中的元素後，應用程式仍會與您定義的所有網域建立關聯。

網域驗證程序需要網路連線，可能需要一段時間才能完成。為提高驗證效率，系統只會驗證指定 Android 12 以上版本的應用程式網域，前提是該網域位於 <intent-filter> 元素內，且包含上述程式碼片段中指定的確切格式。舉例來說，如果使用「http」和「https」以外的配置 (例如 <data android:scheme="custom" />)，<intent-filter>就不會觸發網域驗證。

支援多個主機的應用程式連結

系統必須能夠根據該意圖篩選器中相應網域上代管的 Digital Asset Links 檔案，驗證應用程式網址意圖篩選器資料元素中指定的主機。如果驗證失敗，系統會預設採用標準行為來解析意圖，詳情請參閱「建立應用程式內容的深層連結」。不過，應用程式仍可驗證為應用程式其他意圖篩選器中定義的任何網址模式的預設處理常式。

注意：在 Android 11 (API 級別 30) 以下版本中，除非系統找到與資訊清單中定義的所有主機相符的數位資產連結檔案，否則不會將您的應用程式驗證為預設處理常式。

舉例來說，如果系統在 https://www.example.com/.well-known/assetlinks.json 找到 assetlinks.json 檔案，但未在 https://www.example.net/.well-known/assetlinks.json 找到，則具有下列意圖篩選器的應用程式只會通過 https://www.example.com 的驗證：

<application>

  <activity android:name=”MainActivity”>
    <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="http" />
      <data android:scheme="https" />
      <data android:host="www.example.com" />
    </intent-filter>
  </activity>
  <activity android:name=”SecondActivity”>
    <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="https" />
     <data android:host="www.example.net" />
    </intent-filter>
  </activity>

</application>

注意：系統會合併同一個意圖篩選器中的所有 <data> 元素，以反映合併屬性的所有變化版本。舉例來說，上述第一個意圖篩選器包含的 <data> 元素只會宣告 HTTPS 配置。但它會與其他 <data> 元素合併，因此意圖篩選器會同時支援 http://www.example.com 和 https://www.example.com。因此，如要定義 URI 配置和網域的特定組合，您必須建立個別的意圖篩選器。

支援多個子網域的應用程式連結

Digital Asset Links 通訊協定會將意圖篩選器中的子網域視為不重複的獨立主機。因此，如果意圖篩選器列出多個具有不同子網域的主機，您必須在每個網域發布有效的 assetlinks.json。舉例來說，下列意圖篩選器包含 www.example.com 和 mobile.example.com，做為可接受的意圖網址主機。因此，有效的 assetlinks.json 必須同時發布至 https://www.example.com/.well-known/assetlinks.json 和 https://mobile.example.com/.well-known/assetlinks.json。

<application>
  <activity android:name=”MainActivity”>
    <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="https" />
      <data android:scheme="https" />
      <data android:host="www.example.com" />
      <data android:host="mobile.example.com" />
    </intent-filter>
  </activity>
</application>

或者，如果您使用萬用字元宣告主機名稱 (例如 *.example.com)，則必須在根主機名稱 (example.com) 發布 assetlinks.json 檔案。舉例來說，如果應用程式具有下列意圖篩選器，只要 assetlinks.json 檔案發布至 https://example.com/.well-known/assetlinks.json，應用程式就能通過 example.com 任何子名稱 (例如 foo.example.com) 的驗證：

<application>
  <activity android:name=”MainActivity”>
    <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="https" />
      <data android:host="*.example.com" />
    </intent-filter>
  </activity>
</application>

檢查是否有多個應用程式與同一網域相關聯

如果您發布多個與相同網域相關聯的應用程式，這些應用程式都能順利通過驗證。不過，如果應用程式可以解析完全相同的網域主機和路徑 (例如應用程式的精簡版和完整版)，只有最近安裝的應用程式可以解析該網域的網頁意圖。

在這種情況下，請檢查使用者裝置上是否有可能發生衝突的應用程式 (前提是您具備必要的套件顯示設定)。然後在應用程式中，顯示包含呼叫 queryIntentActivities() 結果的自訂選擇器對話方塊。使用者可以從對話方塊中顯示的相符應用程式清單中，選取偏好的應用程式。

宣告網站關聯

您必須在網站上發布 Digital Asset Links JSON 檔案，指明與網站相關聯的 Android 應用程式，並驗證應用程式的網址意圖。JSON 檔案會使用下列欄位識別相關聯的應用程式：

  • package_name：應用程式 build.gradle 檔案中聲明的應用程式 ID。
  • sha256_cert_fingerprints：應用程式簽署憑證的 SHA256 指紋。您可以使用下列指令，透過 Java 金鑰工具產生指紋： 
    keytool -list -v -keystore my-release-key.keystore
    這個欄位支援多個指紋，可用於支援不同版本的應用程式，例如偵錯和正式版建構作業。

    如果您的應用程式使用 Play 應用程式簽署功能，則在本機執行 keytool 產生的憑證指紋通常不會與使用者裝置上的憑證相符。如要確認應用程式是否使用 Play 應用程式簽署功能，請前往 Play 管理中心的開發人員帳戶，依以下路徑操作：Release > Setup > App signing。如果應用程式使用這項功能，您會在同一頁面找到應用程式的正確 Digital Asset Links JSON 程式碼片段。

下列 assetlinks.json 檔案會將連結開啟權授予 com.example Android 應用程式：

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}]

將網站與多個應用程式建立關聯

網站可以在同一個 assetlinks.json 檔案中宣告與多個應用程式的關聯。下列檔案清單顯示聲明檔案的範例，該檔案會分別宣告與兩個應用程式的關聯，並位於 https://www.example.com/.well-known/assetlinks.json： 

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.puppies.app",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
  },
  {
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.monkeys.app",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}]

不同的應用程式可能會處理同一個網頁主機下不同資源的連結。舉例來說，app1 可以宣告 https://example.com/articles 的意圖篩選器，app2 則可以宣告 https://example.com/videos 的意圖篩選器。

注意：與網域相關聯的多個應用程式，可能使用相同或不同的憑證簽署。

將多個網站與單一應用程式建立關聯

多個網站可以在各自的 assetlinks.json 檔案中，宣告與同一應用程式的關聯。下列檔案清單範例說明如何宣告 example.com 和 example.net 與 app1 的關聯。第一個項目顯示 example.com 與 app1 的關聯：

https://www.example.com/.well-known/assetlinks.json

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.mycompany.app1",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}]

下一個清單顯示 example.net 與 app1 的關聯。只有這些檔案的代管位置不同 (.com 和 .net)：

https://www.example.net/.well-known/assetlinks.json

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.mycompany.app1",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}]

發布 JSON 驗證檔案

您必須將 JSON 驗證檔案發布到下列位置：

https://domain.name/.well-known/assetlinks.json

請務必確認以下事項：

  • 系統會提供 assetlinks.json 檔案，且 content-type 為 application/json。
  • 無論應用程式的意圖篩選器是否將 HTTPS 宣告為資料配置，assetlinks.json 檔案都必須可透過 HTTPS 連線存取。
  • assetlinks.json 檔案必須無需重新導向即可存取 (不得有 301 或 302 重新導向)。
  • 如果應用程式連結支援多個主機網域，您必須在每個網域發布 assetlinks.json 檔案。請參閱「支援多個主機的應用程式連結」。
  • 請勿發布應用程式，因為資訊清單檔案中含有一般大眾可能無法存取的開發/測試網址 (例如只能透過 VPN 存取的網址)。在這種情況下，解決方法是設定建構變數，為開發版本產生不同的資訊清單檔案。

Android 應用程式連結驗證

如果應用程式的意圖篩選器中至少有一個包含 android:autoVerify="true"，在搭載 Android 6.0 (API 級別 23) 以上版本的裝置上安裝應用程式時，系統會自動驗證與應用程式意圖篩選器中網址相關聯的主機。在 Android 12 以上版本中，您也可以手動叫用驗證程序，測試驗證邏輯。

自動驗證

系統的自動驗證程序包括：

  1. 系統會檢查所有包含下列任一項目的意圖篩選器：
    • 動作：android.intent.action.VIEW
    • 類別：android.intent.category.BROWSABLE和 android.intent.category.DEFAULT
    • 資料結構定義：http 或 https
  2. 針對上述意圖篩選器中找到的每個專屬主機名稱，Android 會在 https://hostname/.well-known/assetlinks.json 查詢對應網站的 Digital Asset Links 檔案。

確認要與應用程式建立關聯的網站清單，並確認代管的 JSON 檔案有效後，請在裝置上安裝應用程式。請等待至少 20 秒，非同步驗證程序才會完成。使用下列指令，檢查系統是否已驗證您的應用程式並設定正確的連結處理政策：

adb shell am start -a android.intent.action.VIEW \
    -c android.intent.category.BROWSABLE \
    -d "http://domain.name:optional_port"

手動驗證

從 Android 12 開始，您可以手動為裝置上安裝的應用程式叫用網域驗證。無論應用程式是否指定 Android 12，您都可以執行這項程序。

建立網際網路連線

如要驗證網域，測試裝置必須連上網際網路。

支援更新後的網域驗證程序

如果應用程式指定 Android 12 以上版本，系統會自動使用更新後的網域驗證程序。

否則，您可以手動啟用更新後的驗證程序。如要這麼做，請在終端機視窗中執行下列指令：

adb shell am compat enable 175408749 PACKAGE_NAME

在裝置上重設 Android 應用程式連結的狀態

在裝置上手動叫用網域驗證前，請務必重設測試裝置上的 Android 應用程式連結狀態。方法是在終端機視窗中執行下列指令：

adb shell pm set-app-links --package PACKAGE_NAME 0 all

這項指令會將裝置恢復到使用者為任何網域選擇預設應用程式前的狀態。

啟動網域驗證程序

重設裝置上的 Android 應用程式連結狀態後，您就可以執行驗證。方法是在終端機視窗中執行下列指令：

adb shell pm verify-app-links --re-verify PACKAGE_NAME

查看驗證結果

驗證代理程式完成要求後，請查看驗證結果。如要進行這項操作，請執行下列指令：

adb shell pm get-app-links PACKAGE_NAME

這個指令會輸出類似以下的結果：

com.example.pkg:
    ID: 01234567-89ab-cdef-0123-456789abcdef
    Signatures: [***]
    Domain verification state:
      example.com: verified
      sub.example.com: legacy_failure
      example.net: verified
      example.org: 1026

成功通過驗證的網域，網域驗證狀態會顯示為 verified。如果顯示其他狀態，表示系統無法驗證網域。特別是 none 狀態，表示驗證代理人可能尚未完成驗證程序。

以下列出網域驗證可能為特定網域傳回的值：

none
尚未記錄這個網域的資料。請再等幾分鐘，讓驗證代理程式完成與網域驗證相關的要求，然後再次啟動網域驗證程序。
verified
網域已通過驗證，可供聲明應用程式使用。
approved
網域已強制獲准，通常是透過執行殼層指令。
denied
網域遭到強制拒絕，通常是透過執行殼層指令。
migrated
系統保留了先前使用舊版網域驗證程序的結果。
restored
使用者還原資料後，網域已獲准。前提是網域先前已通過驗證。
legacy_failure
網域遭舊版驗證工具拒絕。具體失敗原因不明。
system_configured
裝置設定自動核准了網域。
錯誤代碼大於或等於 1024

裝置驗證器專屬的自訂錯誤代碼。

請建立網路連線，然後再次啟動網域驗證程序。

要求使用者將應用程式與網域建立關聯

應用程式取得網域核准的另一種方式，是要求使用者將應用程式與該網域建立關聯。

檢查應用程式是否已獲准使用該網域

在提示使用者之前，請先檢查應用程式是否為 <intent-filter> 元素中定義網域的預設處理常式。您可以使用下列其中一種方法查詢核准狀態：

DomainVerificationManager

下列程式碼片段展示如何使用 DomainVerificationManager API：

Kotlin

val context: Context = TODO("Your activity or fragment's Context")
val manager = context.getSystemService(DomainVerificationManager::class.java)
val userState = manager.getDomainVerificationUserState(context.packageName)

// Domains that have passed Android App Links verification.
val verifiedDomains = userState?.hostToStateMap
    ?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_VERIFIED }

// Domains that haven't passed Android App Links verification but that the user
// has associated with an app.
val selectedDomains = userState?.hostToStateMap
    ?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_SELECTED }

// All other domains.
val unapprovedDomains = userState?.hostToStateMap
    ?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_NONE }

Java

Context context = TODO("Your activity or fragment's Context");
DomainVerificationManager manager =
        context.getSystemService(DomainVerificationManager.class);
DomainVerificationUserState userState =
        manager.getDomainVerificationUserState(context.getPackageName());

Map<String, Integer> hostToStateMap = userState.getHostToStateMap();
List<String> verifiedDomains = new ArrayList<>();
List<String> selectedDomains = new ArrayList<>();
List<String> unapprovedDomains = new ArrayList<>();
for (String key : hostToStateMap.keySet()) {
    Integer stateValue = hostToStateMap.get(key);
    if (stateValue == DomainVerificationUserState.DOMAIN_STATE_VERIFIED) {
        // Domain has passed Android App Links verification.
        verifiedDomains.add(key);
    } else if (stateValue == DomainVerificationUserState.DOMAIN_STATE_SELECTED) {
        // Domain hasn't passed Android App Links verification, but the user has
        // associated it with an app.
        selectedDomains.add(key);
    } else {
        // All other domains.
        unapprovedDomains.add(key);
    }
}

指令列程式

在開發期間測試應用程式時，您可以執行下列指令，查詢貴機構擁有的網域驗證狀態：

adb shell pm get-app-links --user cur PACKAGE_NAME

在下列範例輸出中，即使應用程式未通過「example.org」網域的驗證，使用者 0 仍在系統設定中手動核准了該應用程式，且沒有其他套件通過該網域的驗證。

com.example.pkg:
ID: ***
Signatures: [***]
Domain verification state:
  example.com: verified
  example.net: verified
  example.org: 1026
User 0:
  Verification link handling allowed: true
  Selection state:
    Enabled:
      example.org
    Disabled:
      example.com
      example.net

您也可以使用殼層指令模擬使用者選取與特定網域相關聯應用程式的程序。如要查看這些指令的完整說明，請參閱 adb shell pm 的輸出內容。

提供要求背景資訊

提出網域核准要求前，請先向使用者說明情況。舉例來說，您可以向使用者顯示啟動畫面、對話方塊或類似的 UI 元素，說明應用程式應成為特定網域的預設處理常式。

提出要求

使用者瞭解應用程式要求執行的動作後，再提出要求。 如要執行此操作，請叫用含有 ACTION_APP_OPEN_BY_DEFAULT_SETTINGS 意圖動作的意圖，以及與目標應用程式的 package:com.example.pkg 相符的資料字串，如以下程式碼片段所示：

Kotlin

val context: Context = TODO("Your activity or fragment's Context")
val intent = Intent(Settings.ACTION_APP_OPEN_BY_DEFAULT_SETTINGS,
    Uri.parse("package:${context.packageName}"))
context.startActivity(intent)

Java

Context context = TODO("Your activity or fragment's Context");
Intent intent = new Intent(Settings.ACTION_APP_OPEN_BY_DEFAULT_SETTINGS,
    Uri.parse("package:" + context.getPackageName()));
context.startActivity(intent);

意圖叫用後，使用者會看到名為「Open by default」(依預設開啟) 的設定畫面。這個畫面包含名為「開啟支援的連結」的單選按鈕，如圖 1 所示。

使用者開啟「開啟支援的連結」後，系統會在「要在這個應用程式中開啟的連結」部分下方顯示一組核取方塊。使用者可以在這裡選取要與應用程式建立關聯的網域。他們也可以選取「新增連結」來新增網域，如圖 2 所示。使用者之後選取所加入網域中的任何連結時，系統會自動在您的應用程式中開啟該連結。

啟用圓形按鈕後，畫面底部附近會顯示一個區段，內含核取方塊和「新增連結」按鈕
圖 1. 系統設定畫面，使用者可以在其中選擇預設在應用程式中開啟的連結。
每個核取方塊代表一個可新增的網域。對話方塊的按鈕為「取消」和「新增」。
圖 2. 對話方塊，使用者可選擇要與應用程式建立關聯的其他網域。

開啟應用程式中無法驗證的網域

您的應用程式主要功能可能是以第三方的身分開啟連結，但無法驗證處理的網域。如果是這種情況，請向使用者說明，他們選取網頁連結時，無法選擇要使用第一方應用程式還是您的 (第三方) 應用程式。使用者必須手動將網域與您的第三方應用程式建立關聯。

此外，如果使用者偏好在第一方應用程式中開啟連結，請考慮導入對話方塊或 Trampoline 活動，做為 Proxy。設定這類對話方塊或暫時性活動前，請先設定應用程式，確保應用程式可瀏覽套件，並查看與應用程式網頁意圖篩選器相符的第一方應用程式。

測試應用程式連結

實作應用程式連結功能時，請測試連結功能，確保系統能將應用程式與網站建立關聯，並如預期處理網址要求。

如要測試現有的對帳單檔案，可以使用 對帳單清單產生器和測試工具。

確認要驗證的主機清單

測試時，請確認系統應為應用程式驗證的相關聯主機清單。請列出所有網址，這些網址對應的意圖篩選器包含下列屬性和元素：

  • 值為 http 或 https 的 android:scheme 屬性
  • android:host 屬性，其中包含網域網址模式
  • android.intent.action.VIEW 動作元素
  • android.intent.category.BROWSABLE 類別元素

請使用這份清單，確認每個具名主機和子網域都提供 Digital Asset Links JSON 檔案。

確認 Digital Asset Links 檔案

針對每個網站，使用 Digital Asset Links API 確認 Digital Asset Links JSON 檔案已正確代管及定義：

https://digitalassetlinks.googleapis.com/v1/statements:list?
   source.web.site=https://domain.name:optional_port&
   relation=delegate_permission/common.handle_all_urls

在測試過程中，您可以檢查目前的連結處理系統設定。 使用下列指令，取得連線裝置上所有應用程式的現有連結處理政策清單：

adb shell dumpsys package domain-preferred-apps

或者，下列程式碼也會執行相同操作：

adb shell dumpsys package d

注意：安裝應用程式後，請務必等待至少 20 秒，讓系統完成驗證程序。

這項指令會傳回裝置上定義的每個使用者或設定檔清單，並在清單前加上以下格式的標頭：

App linkages for user 0:

在這個標頭之後，輸出內容會使用下列格式，列出該使用者的連結處理設定：

Package: com.android.vending
Domains: play.google.com market.android.com
Status: always : 200000002

這份清單會顯示該使用者的應用程式與網域關聯：

  • Package：根據應用程式資訊清單中宣告的套件名稱識別應用程式。
  • Domains - 顯示這個應用程式處理的網頁連結完整主機清單，並以空白字元做為分隔符。
  • Status：顯示這個應用程式目前的連結處理設定。如果應用程式通過驗證，且資訊清單包含 android:autoVerify="true"，狀態會顯示為 always。這個狀態後方的十六進位數字，與 Android 系統記錄的使用者應用程式連結偏好設定有關。這個值不會指出驗證是否成功。

注意：如果使用者在驗證完成前變更應用程式連結設定，即使驗證失敗，您仍可能會看到驗證成功的誤判結果。不過，如果使用者明確啟用應用程式，允許應用程式在不詢問的情況下開啟支援的連結，這項驗證失敗就不會造成影響。這是因為使用者偏好設定的優先順序高於程式輔助驗證 (或缺乏驗證)。因此，連結會直接連往您的應用程式，不會顯示對話方塊，就像驗證成功一樣。

測試範例

如要成功驗證應用程式連結，系統必須能針對您在符合應用程式連結條件的指定意圖篩選器中，驗證應用程式與每個網站的連結。以下範例顯示定義多個應用程式連結的資訊清單設定： 

<application>

    <activity android:name=”MainActivity”>
        <intent-filter android:autoVerify="true">
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="https" />
            <data android:scheme="https" />
            <data android:host="www.example.com" />
            <data android:host="mobile.example.com" />
        </intent-filter>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="https" />
            <data android:host="www.example2.com" />
        </intent-filter>
    </activity>

    <activity android:name=”SecondActivity”>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="https" />
            <data android:host="account.example.com" />
        </intent-filter>
    </activity>

      <activity android:name=”ThirdActivity”>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <data android:scheme="https" />
            <data android:host="map.example.com" />
        </intent-filter>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="market" />
            <data android:host="example.com" />
        </intent-filter>
      </activity>

</application>

平台會嘗試從上述資訊清單驗證的主機清單如下： 

www.example.com
mobile.example.com
www.example2.com
account.example.com

平台不會嘗試驗證上述資訊清單中的主機清單： 

map.example.com (it does not have android.intent.category.BROWSABLE)
market://example.com (it does not have either an "http" or "https" scheme)

如要進一步瞭解對帳單清單，請參閱 建立對帳單清單。

修正常見的導入錯誤

如果無法驗證 Android 應用程式連結，請檢查下列常見錯誤。本節使用 example.com 做為預留位置網域名稱；執行這些檢查時，請將 example.com 替換為伺服器的實際網域名稱。

意圖篩選器設定有誤
檢查您是否在 <intent-filter> 元素中加入應用程式不擁有的網址。
伺服器設定有誤

檢查伺服器的 JSON 設定，確認 SHA 值正確無誤。

此外，請檢查 example.com. (結尾有句號) 是否與 example.com 提供相同的內容。

伺服器端重新導向

如果您設定了下列重新導向，系統就不會驗證應用程式的任何 Android 應用程式連結：

  • http://example.com到https://example.com
  • example.com到www.example.com

這項行為可保護應用程式安全。

伺服器穩定性

檢查伺服器是否能連線至用戶端應用程式。

無法驗證的連結

如果是測試用途，您可能會刻意加入無法驗證的連結。請注意，在 Android 11 以下版本中，這些連結會導致系統無法驗證應用程式的所有 Android 應用程式連結。

assetlinks.json 中的簽名有誤

確認簽名正確無誤，且與用於簽署應用程式的簽名相符。常見錯誤包括：

  • 使用偵錯憑證簽署應用程式，且 assetlinks.json 中只有發布簽章。
  • 在 assetlinks.json 中使用小寫簽名。簽名應為大寫。
  • 如果您使用 Play 應用程式簽署功能，請務必使用 Google 簽署各個版本時所用的簽章。如要驗證這些詳細資料 (包括完整的 JSON 程式碼片段)，請按照宣告網站關聯的說明操作。