在 Google Play 上架 PWA 後,即可在全世界最大的應用程式商店中曝光。Google Play 也提供應用程式評分和評論,讓使用者在安裝 PWA 前先瞭解相關資訊。最後,在 Google Play 中列出應用程式時,您還能使用 Google Play 結帳系統,為使用者提供熟悉的付款平台,同時支援多個國家/地區的付款方式。
Bubblewrap
Bubblewrap 是一種 CLI,可將漸進式網頁應用程式封裝在 Android 應用程式套件中,透過應用程式商店 (例如 ChromeOS 和 Android 上的 Play) 發布,完全不需要 Android 應用程式開發知識。
如要開始使用,請從 NPM 安裝 Bubblewrap:
$ npm install -g @bubblewrap/cli
如要初始化專案,請傳入 PWA 的網頁應用程式資訊清單做為輸入內容,Bubblewrap 會產生 Android 專案,用於建構 PWA Play 套件。
$ bubblewrap init --manifest=""
接著建構專案,Bubblewrap 就會建立可上傳至 Google Play 發布的套件 (APK 或 AAB)。
$ bubblewrap build
如需快速入門指南和指令的詳細資訊,請參閱官方 CLI 說明文件。
僅限 ChromeOS
如果您已有平台專屬的 Android 應用程式,或不希望提供行動版體驗,可以在 init 指令中加入 --chromeosonly 標記,讓應用程式僅適用於 ChromeOS:
$ bubblewrap init --manifest="" --chromeosonly
如果已初始化應用程式,請在 twa-manifest.json 檔案中將 isChromeOSOnly 標記設為 true,然後執行 Bubblewrap 的 update 指令,即可變更這項設定。
簽署金鑰
簽署金鑰會將您指定為應用程式的原始作者,且應用程式的任何更新都必須使用原始簽署金鑰。初始化專案時,Bubblewrap 會要求您提供現有金鑰,或為您建立新金鑰。
請務必保護這組金鑰,並妥善保管。如果遺失這個金鑰,可能很難在 Google Play 更新應用程式。
Digital Asset Links
設定 Digital Asset Links 需要多個步驟:您必須從 Google Play 收集應用程式資訊,並在網路應用程式的特定位置部署檔案。如需設定 PWA 的 Digital Asset Links 提示,請觀看下方影片:
自發布這部影片以來,Bubblewrap 不再為您產生 Digital Asset Links 檔案。請改用工具中的 fingerprint 指令。
將應用程式發布至 Google Play
準備好將應用程式發布到 Google Play 時,請按照下列步驟操作:
- 請確認已設定 Google Play 開發人員帳戶。
- 確認開發人員帳戶詳細資料正確無誤。
- 如果使用 Google Play 結帳服務,請設定 Google 付款商家帳戶,並連結至 Google Play 帳戶。
- 在 Google Play 中建立應用程式資訊。
您現在可以將應用程式發布至 Google Play!建議您先發布到測試群組,並邀請可信任的測試人員進行測試,確認應用程式運作正常。
注意:對於在 Google Play 發布的 PWA,我們不建議採用付費應用程式選項。使用者必須能透過瀏覽器存取已安裝的 PWA,而判斷導覽是否來自 Play 安裝應用程式的唯一方法是進行用戶端檢查,且這類檢查可能不會在每次導覽時觸發。因此,我們無法像其他付費應用程式一樣,以安全的方式限制存取權,建議您改為透過應用程式內購和/或訂閱服務營利。
在一個項目中列出 ChromeOS 適用的 PWA 和特定平台的 Android 應用程式
如果您已在 Android 平台推出專屬應用程式,並想在 Google Play 發布僅適用於 Chromebook 的 PWA,可以在同一個商店資訊中完成所有操作。請務必在封裝 PWA 時,使用上述僅限 ChromeOS 的旗標。這樣一來,PWA 版本就只會提供給 Chromebook。如果 PWA 和 Android 應用程式要共用 Play 商店資訊,就必須使用相同的簽署金鑰。
警告:如果上傳的 Android 行動應用程式版本號碼高於 ChromeOS 專用應用程式,且該 Android 行動應用程式也與 Chromebook 相容,則系統會以該 Android 行動應用程式取代 ChromeOS 專用應用程式!最佳做法是將 ChromeOS 應用程式版本設為比 Android 行動應用程式高出幾個版本。舉例來說,如果 Android 版本是 1,ChromeOS 版本可以設為 1000。然後,為每個版本建立新版本時,只要 ChromeOS 版本號碼一律較大,即可相應遞增版本號碼。Play 發行應用程式時,會使用與指定裝置相容的最高版本。
建立 ChromeOS 版本時,請務必納入最新發布的 Android App Bundle。如果 ChromeOS 版本未納入最新的行動裝置套件,行動裝置上的 Android 使用者就無法安裝您的應用程式。在「先前版本」部分中,找出對應最新 Android 行動裝置版本的 APK 或 AAB,然後選取「包含」。

同樣地,建立 Android 版本時,您也需要加入最新發布的 ChromeOS 專用應用程式套件。否則,使用者在 ChromeOS 裝置上首次安裝應用程式時,系統會提供 Android 應用程式,而非 ChromeOS 應用程式。
遵守 Google Play 付款政策
如果 PWA 銷售的數位商品屬於 Play 付款政策規範的範圍,您必須先將 Play 結帳系統整合至應用程式,才能啟動應用程式。進一步瞭解如何將 Google Play 帳款服務與網頁應用程式整合。
在 Play 中更新 PWA
使用者透過 Google Play 安裝 PWA 後,會使用即時網路應用程式,因此只有在少數情況下,您才需要更新已部署的應用程式,包括:
- 如果應用程式已發布超過一年,在這種情況下,您應更新 SDK,確保應用程式能與最新版 Android SDK 搭配運作。
- 如果同一應用程式資訊下有行動裝置和僅限 ChromeOS 的套件,且平台專屬的 Android 版本號碼高於僅限 ChromeOS 的 PWA 版本,在這種情況下,您需要調升 PWA 版本,並重新部署應用程式,同時保留平台專屬的 Android 應用程式版本。
- 如要使用新功能。
- 如果您變更了網頁應用程式資訊清單 (例如更新圖示或主題顏色),並希望這些變更套用至 Play 中的 PWA,在這種情況下,您應重新編譯 Bubblewrap 專案,然後重新部署應用程式。