受信任的網路活動是將 PWA 等網頁應用程式內容與 使用以「自訂分頁」為基礎的通訊協定來開發 Android 應用程式。
「受信任的網路活動」需要開啟來源以使用 Digital Asset Links,用於以全螢幕顯示內容。
當使用者離開已驗證的來源時,畫面會顯示「Custom Tab UI」。自訂版面中的網址列 這個分頁會顯示使用者目前正前往應用程式外的網域,以及 提供 X 按鈕,讓使用者可以快速回到已驗證的來源。
不過,網頁應用程式也常會建立橫跨多個來源的使用體驗,例如 應是購買應用程式,主要服務位於 www.example.com,而結帳 流量託管於 checkout.example.com。
這時您不希望顯示自訂分頁,不僅是因為使用者目前在 也是因為頂端列可能會讓使用者誤以為已離開應用程式 並放棄結帳
「Trusted Web Activities」可讓開發人員驗證多個來源,而使用者會持續留在 全螢幕畫面。和主網域一樣,開發人員必須是 能夠控管每個經過驗證的來源
設定多個來源的驗證作業
與主要來源相同,驗證程序是透過 Digital Asset Links 通過,每個網域 通過驗證後,必須有專屬的 assetlinks.json 檔案
為每個來源新增 assetlinks 檔案
以 www.example.com 和 checkout.example.com 為例,範例如下:
https://www.example.com/.well-known/assetlinks.json
https://checkout.example.com/.well-known/assetlinks.json
每個網域都連結至同一個 Android 應用程式,因此 assetlinks.json
檔案
看起來都一樣
假設 Android 應用程式的套件名稱是 com.example.twa
,兩者都是 assetlink.json
檔案會包含類似以下的內容:
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example",
"sha256_cert_fingerprints": ["..."]}
}]
在 Android 應用程式中新增多個來源
在 Android 應用程式中,asset_statements
宣告需要更新,才能包含所有
需要驗證的來源:
<string name="asset_statements">
[{
\"relation\": [\"delegate_permission/common.handle_all_urls\"],
\"target\": {
\"namespace\": \"web\",
\"site\": \"https://www.example.com\"
}
}],
[{
\"relation\": [\"delegate_permission/common.handle_all_urls\"],
\"target\": {
\"namespace\": \"web\",
\"site\": \"https://checkout.example.com\"
}
}],
</string>
在 LauncherActivity 中新增其他來源
使用預設的 LauncherActivity
android-browser-helper
支援資料庫中的 LauncherActivity
可讓您藉由設定 Android 專案,新增多個要驗證的來源。
首先,在 res/values/strings.xml
檔案中加入 string-array
元素。每個額外的網址
會位於 item
子元素中:
...
<string-array name="additional_trusted_origins">
<item>https://www.google.com</item>
</string-array>
...
接著,在參照meta-data
AndroidManifest.xml
中的 LauncherActivity
:
...
<activity android:name="com.google.androidbrowserhelper.trusted.LauncherActivity"
android:label="@string/app_name">
<meta-data
android:name="android.support.customtabs.trusted.ADDITIONAL_TRUSTED_ORIGINS"
android:resource="@array/additional_trusted_origins" />
...
</activity>
...
使用自訂 LauncherActivity
使用自訂程式碼啟動受信任的網路活動時,只要在
在建立意圖以啟動受信任的網路活動時呼叫 setAdditionalTrustedOrigins
:
public void launcherWithMultipleOrigins(View view) {
List<String> origins = Arrays.asList(
"https://checkout.example.com/"
);
TrustedWebActivityIntentBuilder builder = new TrustedWebActivityIntentBuilder(LAUNCH_URI)
.setAdditionalTrustedOrigins(origins);
new TwaLauncher(this).launch(builder, null, null);
}
結論
完成上述步驟後,「受信任網路活動」現在就能支援多個來源。 android-browser-helper 提供了多來源受信任網路活動的範例應用程式。廠牌 務必自行檢查。
疑難排解
設定 Digital Asset Links 的過程中有一些變動。如果應用程式仍顯示 自訂分頁列的頂端,可能是設定有誤。
「信任的網路活動」快速入門指南提供實用的疑難排解章節,說明如何 針對 Digital Asset Link 問題進行偵錯。
此外,還有很棒的 Peter 的資產連結工具,可協助偵錯 Digital Asset Links 安裝在裝置上安裝的應用程式