「信任的網路活動」設定可能不容易 顯示您的網站 本指南將逐步引導您建立使用 Trusted Web Activities 的基本專案。 所有儲存空間
完成本指南後,您將:
- 已使用 Bubblewrap 建構應用程式 並使用「信任的網路活動」進行驗證。
- 瞭解簽署金鑰的使用時機。
- 可以判斷建構 Android 應用程式時所採用的簽章。
- 瞭解如何建立基本的 Digital Asset Links 檔案。
如要依循本指南,您必須:
- 在開發電腦上安裝 Node.js 10 以上版本。
- 連接及設定開發用途的 Android 手機或模擬器 (啟用 USB 偵錯功能, 假設你使用實體手機)。
- 支援在開發手機上支援「受信任網路活動」功能的瀏覽器。 支援 Chrome 72 以上版本。未來也將陸續支援其他瀏覽器。
- 您希望在受信任網路活動中查看的網站。
「信任的網路活動」可讓 Android 應用程式在沒有使用者的情況下,啟動全螢幕的瀏覽器分頁 。 這項功能僅限你擁有的網站使用,且你可透過設定證明 新增 Digital Asset Links。我們稍後會詳細介紹。
當您啟動受信任的網路活動時,瀏覽器會檢查 Digital Asset Links 是否通過 這項作業稱為驗證 若驗證失敗,瀏覽器會改回以 自訂分頁:
安裝及設定 Bubblewrap
Bubblewrap 是一組程式庫和指令 Node.js 適用的行工具 (CLI),可協助開發人員產生、建構及執行漸進式網頁應用程式 透過受信任的網路活動,在 Android 應用程式中使用信任的用戶端。
您可以使用下列指令安裝 CLI:
npm i -g @bubblewrap/cli
設定環境
首次執行 Bubblewrap 時,系統會自動下載 所需的外部依附元件建議您允許這項工具完成這項操作,因為這樣可確保 正確設定依附元件參閱 Bubblewrap 說明文件,即可使用 或安裝現有的 Java Development Kit (JDK) 或安裝 Android 指令列工具
初始化並建構專案
如要初始化包裝 PWA 的 Android 專案,請執行 init 指令:
bubblewrap init --manifest=https://my-twa.com/manifest.json
Bubblewrap 隨即會讀取網頁資訊清單, 請開發人員確認要在 Android 專案中使用的值,然後產生 這些值。專案產生後,請執行下列指令來產生 APK:
bubblewrap build
執行
建構步驟會輸出名為 app-release-signed.apk
的檔案。這個檔案可以安裝在
進行測試,或上傳至 Play 商店進行發布。
Bubblewrap 提供用於在本機裝置上安裝及測試應用程式的指令,使用 會執行以下程式碼:
bubblewrap install
或者,adb 工具可能是
adb install app-release-signed.apk
應用程式現在應會顯示在裝置啟動器中。開啟應用程式時 請注意,您的網站是以「自訂分頁」啟動,而非「受信任的網路活動」, 因為我們還沒設定 Digital Asset Links 驗證,但首先...
Bubblewrap 的圖形使用者介面 (GUI) 替代方案
PWA Builder 提供使用 Bubblewrap 的 GUI 介面 程式庫。進一步瞭解 使用 PWA Builder 建立 Android 應用程式, 在 這篇網誌文章。
簽署金鑰注意事項
Digital Asset Links 會考量 APK 使用簽署的金鑰,而且驗證失敗的常見原因為使用的簽章有誤。(請注意,如果驗證失敗,網頁上方將會以瀏覽器使用者介面的形式啟動網站)。當 Bubblewrap 建構應用程式時,系統會在 init
步驟中透過金鑰設定來建立 APK。不過,當您在 Google Play 發布應用程式時,系統可能會根據您選擇處理簽署金鑰的方式,為您建立另一組金鑰。進一步瞭解簽署金鑰以及金鑰與 Bubblewrap 和 Google Play 之間的關係。
設定素材資源連結檔案
Digital Asset Links 主要包含指向您應用程式的網站檔案,以及 應用程式中的中繼資料。
建立 assetlinks.json
檔案後,請將檔案上傳至網站 (相對於根層級 .well-known/assetlinks.json
),以便瀏覽器正確驗證應用程式。如要進一步瞭解 Digital Asset Links 與簽署金鑰之間的關係,請參閱「深入瞭解 Digital Asset Links」。
正在檢查瀏覽器
「受信任的網路活動」會試著採用使用者的預設瀏覽器選項。 如果使用者的預設瀏覽器支援「受信任的網路活動」,就會啟動。 失敗後,如果已安裝的瀏覽器支援「受信任網路活動」,系統就會選擇該活動。 最後,預設行為是改回「自訂分頁」模式。
換句話說,如果您正在偵錯與「Trusted Web Activities」相關的內容, 請確認您使用的瀏覽器是您所熟悉的瀏覽器。 您可以使用下列指令查看目前使用的瀏覽器:
> adb logcat -v brief | grep -e TWAProviderPicker
D/TWAProviderPicker(17168): Found TWA provider, finishing search: com.google.android.apps.chrome
後續步驟
希望您遵循本指南後,即可擁有正常運作的「受信任網路活動」 。 如果沒有,請參閱給網頁開發人員的更多 Android 概念,或針對 相關文件。
建議您從 為應用程式建立圖示。 完成後,您就可以考慮將應用程式部署至 Play 商店。