Android 應用程式連結是一種特殊的深層連結,可讓網站網址立即開啟 Android 應用程式中的對應內容,而不必讓使用者自行選取應用程式。Android 應用程式連結會使用 Digital AssetLinks API 以建立信任感,表示網站已核准您的應用程式,可自動開啟該網域的連結。如果系統成功驗證您擁有網址,就會自動將這些網址意圖轉送至您的應用程式。
如要驗證您同時擁有應用程式和網站網址,請完成下列步驟:
新增包含
autoVerify
屬性的意圖篩選器。此屬性會指示系統驗證您的應用程式是否屬於意圖篩選器中使用的網址網域。在下列位置代管 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". -->
<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
,以維持一致性。這也可確保在移除或重構資訊清單檔案中的元素後,應用程式仍與您仍然定義的所有網域相關聯。
網域驗證程序需要網際網路連線,且可能需要一些時間才能完成。為了提升程序的效率,只有當應用程式的網域位於 <intent-filter>
元素內,且該元素須與上述程式碼片段指定的格式相同時,系統才會驗證指定 Android 12 以上版本應用程式的網域。
支援針對多個主機的應用程式連結
系統必須能夠針對該意圖篩選器中個別網域上代管的 Digital Asset Links 檔案,驗證應用程式網址意圖篩選器資料元素中指定的主機。如果驗證失敗,系統會預設採用標準行為來解析意圖,如「建立應用程式內容的深層連結」一文所述。不過,針對應用程式的其他意圖篩選器中定義的任何網址模式,應用程式仍可驗證為預設處理常式。
注意:在 Android 11 (API 級別 30) 以下版本中,除非在您資訊清單中定義的「所有」主機找到相符的 Digital Asset Links 檔案,否則系統不會將應用程式驗證為預設處理常式。
舉例來說,具有下列意圖篩選器的應用程式只會在 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>
元素合併在一起,以便計算合併屬性的所有變化版本。舉例來說,上面的第一個意圖篩選器包含僅宣告 HTTPS 配置的 <data>
元素。但會與其他 <data>
元素合併使用,因此意圖篩選器同時支援 http://www.example.com
和 https://www.example.com
。因此,如要定義特定 URI 配置和網域組合,您必須建立不同的意圖篩選器。
支援連結多個子網域的應用程式
Digital Asset Links 通訊協定會將意圖篩選器中的子網域視為不重複的獨立主機。因此,如果您的意圖篩選器列出多個擁有不同子網域的主機,您必須在每個網域上發布有效的 assetlinks.json
。舉例來說,下列意圖篩選器將 www.example.com
和 mobile.example.com
列為可接受的意圖網址主機。因此,必須在 https://www.example.com/.well-known/assetlinks.json
和 https://mobile.example.com/.well-known/assetlinks.json
中發布有效的 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
發布,就會通過任何子名稱 (例如 foo.example.com
) 的驗證: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 產生指紋:keytool -list -v -keystore my-release-key.keystore
這個欄位支援多個指紋,可用來支援應用程式的不同版本,例如偵錯和正式版。如果您為應用程式使用 Play 應用程式簽署功能,在本機執行
keytool
產生的憑證指紋通常會與使用者裝置上的憑證指紋不相符。您可以在 Play 管理中心的開發人員帳戶 (Release > Setup > App signing
) 中,確認應用程式是否使用 Play 應用程式簽署功能;如果有的話,您就會在相同頁面找到應用程式的正確 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 的關聯:
[{ "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
):
[{ "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
檔案會與內容類型application/json
一併提供。- 無論應用程式的意圖篩選器是否將 HTTPS 宣告為資料配置,
assetlinks.json
檔案都必須透過 HTTPS 連線存取。 assetlinks.json
檔案必須能在不重新導向的情況下存取 (禁止 301 或 302 重新導向)。- 如果應用程式連結支援多個主機網域,您必須在每個網域上發布
assetlinks.json
檔案。請參閱支援多個主機的應用程式連結。 - 請勿在資訊清單檔案中使用可能無法公開存取的開發/測試網址發布應用程式 (例如只能透過 VPN 存取的任何網址)。在這種情況下,解決方法是設定建構變化版本,為開發版本產生不同的資訊清單檔案。
Android 應用程式連結驗證
如果 android:autoVerify="true"
出現在應用程式的至少一個意圖篩選器中,那麼在搭載 Android 6.0 (API 級別 23) 以上版本的裝置上安裝應用程式,系統就會自動驗證與應用程式意圖篩選器內網址相關聯的主機。在 Android 12 以上版本中,您也可以手動叫用驗證程序以測試驗證邏輯。
自動驗證
系統的自動驗證包含下列項目:
- 系統會檢查包含下列任一項的意圖篩選器:
- 操作:
android.intent.action.VIEW
- 類別:
android.intent.category.BROWSABLE
和android.intent.category.DEFAULT
- 資料配置:
http
或https
- 操作:
- 針對在上述意圖篩選器中找到的每個不重複主機名稱,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
API (在執行階段)。- 指令列程式 (測試期間)。
網域驗證管理員
下列程式碼片段說明如何使用 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」(預設開啟) 的設定畫面。此畫麵包含名為「Open supported links」圓形按鈕,如圖 1 所示。
使用者開啟「開啟支援的連結」後,「要在這個應用程式中開啟的連結」部分下方會顯示一組核取方塊。使用者可在其中選取要與應用程式建立關聯的網域,也可以選取「Add link」新增網域,如圖 2 所示。當使用者稍後選取自己新增的網域中的任何連結時,連結就會自動開啟在應用程式中。
開啟應用程式無法驗證的網域
應用程式的主要功能可能是以第三方形式開啟連結,而無法驗證已處理的網域。在這種情況下,請向使用者說明,使用者選取網頁連結後,就無法在第一方應用程式和您的 (第三方) 應用程式之間做出選擇。使用者必須手動將網域連結至第三方應用程式。
此外,建議您導入對話方塊或 Trampoline 活動,如果使用者偏好這麼做,也能在第一方應用程式中開啟連結,並以 Proxy 的形式運作。設定這類對話方塊或 Trampoline 活動前,請先設定您的應用程式,使應用程式具有套件瀏覽權限,使其位於與應用程式網頁意圖篩選器相符的第一方應用程式中。
測試應用程式連結
導入應用程式連結功能時,建議您測試連結功能,確保系統能夠將您的應用程式與網站建立關聯,並照常處理網址要求。
如要測試現有的陳述式檔案,可以使用 陳述式清單產生器和測試人員工具。
確認要驗證的主機清單
測試時,您應確認系統應為應用程式驗證的關聯主機清單。列出所有網址的對應意圖篩選器包含下列屬性和元素:
android:scheme
屬性,其值為http
或https
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 程式碼片段,請按照宣告網站關聯的操作說明進行。
- 使用偵錯憑證簽署應用程式,且