在 Android 應用程式中使用 PWA

在 Android 應用程式中啟動 PWA

漸進式網頁應用程式 (PWA) 是使用類似應用程式的功能,打造快速、可靠且引人入勝的高品質體驗。

網路的觸及範圍極廣,可讓使用者以各種方式發掘新體驗。但使用者也習慣在作業系統商店中搜尋應用程式。在許多情況下,這些使用者已經熟悉他們正在尋找的品牌或服務,且有高度意願,因此參與度指標高於平均值。

Play 商店是 Android 應用程式商店,開發人員通常會想從 Android 應用程式開啟漸進式網頁應用程式。

受信任的網路活動是一項開放標準,可讓瀏覽器提供與網路平台完全相容的容器,在 Android 應用程式中算繪 PWA。這項功能適用於 Chrome,目前正在 Firefox Nightly 中開發。

現有解決方案有限

您一向可以使用 Android WebView 等技術或 Cordova 等架構,在 Android 應用程式中加入網頁體驗。

Android WebView 的限制在於,它並非用來取代瀏覽器。Android WebView 是開發人員工具,用於在 Android 應用程式中使用網頁 UI,不提供現代網頁平台功能的完整存取權,例如聯絡人選擇工具或檔案系統等。

Cordova 的設計目的是彌補 WebView 的缺點,但 API 僅限於 Cordova 環境。這表示您需要維護額外的程式碼集,才能在 Android 應用程式中使用 Cordova API,與開放式網路上的 PWA 分開。

此外,功能曝光度通常不一定能如預期運作,Android 版本和原始設備製造商 (OEM) 之間的相容性問題也可能造成問題。使用這類解決方案時,開發人員需要額外的品質查驗程序,並產生額外的開發成本,才能偵測及建立解決方法。

受信任的網路活動是 Android 網頁應用程式的新容器

開發人員現在可以使用受信任的網路活動做為容器,將 PWA 做為 Android 應用程式的啟動活動。這項技術會利用瀏覽器以全螢幕模式算繪 PWA,確保受信任的網路活動與基礎瀏覽器具有相同的網路平台功能和 API 相容性。此外,您也可以使用開放原始碼公用程式,更輕鬆地透過受信任的網路活動導入 Android 應用程式。

另一個優勢是容器會與瀏覽器共用儲存空間,這是其他解決方案無法提供的。登入狀態和使用者偏好設定可在不同體驗之間順暢共用。

瀏覽器相容性

Chrome 自 75 版起就支援這項功能,Firefox 則是在 Nightly 版本中實作。

品質條件

網頁程式開發人員如想在 Android 應用程式中加入網路內容,應使用受信任的網路活動。

受信任的網路活動中的網路內容必須符合 PWA 安裝條件。

此外,為了符合使用者對 Android 應用程式的預期行為,Chrome 86 導入了一項變更,如果無法處理下列情況,就會視為當機:

  • 應用程式啟動時無法驗證數位資產連結。
  • 離線網路資源要求未傳回 HTTP 200。
  • 導覽要求傳回 HTTP 404 或 5xx 錯誤。

當受信任的網路活動發生上述任一情況時,Android 應用程式就會當機,使用者也會看到。請參閱指南,瞭解如何在 Service Worker 中處理這些情況。

應用程式也必須符合其他 Android 專屬條件,例如政策遵循。

螢幕截圖:顯示 AirHorn 的 Lighthouse 分數,其中包含 PWA 徽章和 100 分的效能分數。
Lighthouse 的 PWA 徽章會顯示 PWA 是否符合安裝條件。

工具

網頁程式開發人員如想利用受信任的網路活動,不必學習新技術或 API,就能將 PWA 轉換為 Android 應用程式。Bubblewrap 和 PWABuilder 共同提供程式庫、指令列介面 (CLI) 和圖形使用者介面 (GUI) 形式的開發人員工具。

Bubblewrap

Bubblewrap 專案會以 NodeJS 程式庫和指令列介面 (CLI) 的形式產生 Android 應用程式。

如要啟動新專案,請執行工具並傳遞網頁資訊清單的網址:

npx @bubblewrap/cli init --manifest=https://pwa-directory.appspot.com/manifest.json

這項工具也可以建構專案,執行下列指令會輸出可上傳至 Play 商店的 Android 應用程式:

npx @bubblewrap/cli build

執行這個指令後,專案的根目錄中會出現名為 app-release-signed.apk 的檔案。這個檔案會上傳到 Play 商店。

PWABuilder

PWABuilder 可協助開發人員將現有網站轉換為漸進式網頁應用程式。此外,這項工具也與 Bubblewrap 整合,提供 GUI 介面,可將這些 PWA 包裝成 Android 應用程式。PWABuilder 團隊撰寫了一篇優質網誌文章,說明如何使用這項工具產生 Android 應用程式。

在 Android 應用程式中驗證 PWA 擁有權

開發人員建構出色的漸進式網頁應用程式後,不會希望其他開發人員在未經許可的情況下,使用該應用程式建構 Android 應用程式。為避免這種情況,Android 應用程式必須使用名為 Digital Asset Links 的工具與漸進式網頁應用程式配對。

Bubblewrap 和 PWABuilder 會處理 Android 應用程式的必要設定,但最後一個步驟是將 assetlinks.json 檔案新增至 PWA。

如要產生這個檔案,開發人員需要金鑰的 SHA-256 簽章,用於簽署使用者下載的 APK。

金鑰可以透過多種方式產生,如要找出簽署提供給使用者 APK 的金鑰,最簡單的方法是直接從 Play 商店下載。

為避免向使用者顯示損壞的應用程式,請將應用程式部署至封閉測試管道,並安裝至測試裝置,然後使用 Peter 的 Asset Link 工具為應用程式產生正確的 assetlinks.json 檔案。請在要驗證的網域中,將產生的 assetlinks.json 檔案放在 /.well-known/assetlinks.json。

後續步驟

漸進式網頁應用程式可提供優質的網頁體驗。如果符合最低品質標準,受信任的網路活動可讓您透過 Android 應用程式開啟這些優質體驗。

如果您剛開始使用漸進式網頁應用程式,請參閱如何建構優質 PWA 的指南。如果開發人員已有 PWA,請使用 Lighthouse 驗證是否符合品質標準。

接著,使用 Bubblewrap 或 PWABuilder 產生 Android 應用程式,將應用程式上傳至 Play 商店的封閉測試管道,並使用 Peter 的 Asset Link 工具將應用程式與 PWA 配對。

最後,將應用程式從封閉測試管道移至正式版!