Polar Games
攻略

HTML5 遊戲上架 Google Play：Capacitor 教學

從遊戲資料夾到簽署好的應用程式套件，Play 管理中心的各項表單、新帳戶的 12 位測試人員規定，以及我們自家 App 在 WebView 裡遇過的問題。

Velvet Pool 的主視覺。這是一款 8 號球撞球範本，Polar Games 也把它封裝成了 Android App。

想讓 HTML5 遊戲上架 Google Play，做法是：用 Capacitor 把遊戲資料夾包進原生 Android 專案，在 Android Studio 建置簽署過的 Android App Bundle，在 Play 管理中心建立應用程式、填完內容表單，先把套件上傳到測試群組，再推到正式版。如果你的開發人員帳戶是 2023 年 11 月 13 日之後建立的個人帳戶，Google 還要求先跑一輪封閉測試，至少 12 位測試人員、連續 14 天，才能申請正式版。

這些步驟我們在自己的遊戲上走過。2026 年 10 月，我們用 Capacitor 封裝了 Ricopop 和 Velvet Pool，兩款都送交 Google Play 正式版審查，動作遊戲 Little Ninja Dash 也是。本文綜合了 Capacitor、Android 與 Play 管理中心官方頁面的說明（2026 年 10 月 30 日查閱），以及我們自己發布紀錄裡的經驗。規定和要求會變動，送審前請逐一確認文中提到的頁面。

HTML5 遊戲上架 Google Play 前的準備

  • 一個 Google Play 開發人員帳戶。Google 收取一次性註冊費 25 美元，並要求每位開發人員驗證身分。個人帳戶在發布前還必須透過 Play 管理中心行動版 App，驗證自己能使用 Android 裝置。
  • Node.js 和 Android Studio。Capacitor 的 Android 文件說明，Capacitor Android App 是透過 Android Studio 設定和管理的。
  • 一款能在自己的資料夾內離線執行的遊戲，根目錄要有 index.html。
  • 遊戲的授權。我們的範本一份授權對應一個最終產品，你可以把這款遊戲發布到任何地方，包含 Google Play 和 App Store，但不能轉售範本本身。若要收費或加入應用程式內購，請先問我們，因為我們的條款寫的是玩家免費或透過廣告使用產品。

我們的範本版本是瀏覽器遊戲。每個版本頁面都註明不含原生 App 建置，所以下面的步驟要由你自己完成，或是請我們報價代工。

看看 Velvet Pool，我們也封裝成 Android 版的撞球範本

步驟 1：用 Capacitor 封裝遊戲資料夾

Capacitor 需要一個 package.json、一個放建置好的網頁檔案的資料夾，以及資料夾根目錄的 index.html。它的入門頁面提醒，index.html 一定要有 head 標籤，否則外掛無法運作。下載來的 HTML5 範本通常已經有這個資料夾，我們的範本裡是 game/。

  1. 在新的專案資料夾執行 npm i @capacitor/core 和 npm i -D @capacitor/cli。
  2. 執行 npx cap init。它會詢問 App 名稱、App ID（反向網域，例如 com.yourstudio.yourgame）和網頁資料夾。把 webDir 指向你的遊戲資料夾。
  3. 執行 npm i @capacitor/android，接著執行 npx cap add android，產生 android/ 專案。
  4. 每次修改遊戲檔案後都執行 npx cap sync，把檔案複製進原生專案。
  5. 執行 npx cap open android，在 Android Studio 開啟專案。

Capacitor 文件寫明支援 API 24 以上，也就是 Android 7 以上。我們的 Android 專案就採用這個最低版本。

我們的做法有點不同：原生專案放在獨立的 mobile/ 工作區，由它把遊戲複製到自己的網頁資料夾。網站版完全不動，只屬於 App 的東西，例如原生廣告，都放在這個工作區。

步驟 2：建置並簽署應用程式套件

從 2021 年 8 月起，Google Play 上的新應用程式必須以 Android App Bundle（AAB）發布，不再接受 APK。在 Android Studio 依序選 Build、Generate Signed Bundle/APK，選擇 Android App Bundle，再建立或選取 keystore。

這個 keystore 存放你的上傳金鑰。Google 的應用程式簽署說明頁解釋：採用 Play 應用程式簽署（新應用程式首次發布時必須設定）後，應用程式簽署金鑰由 Google 保管，你則用上傳金鑰簽署每一次上傳。上傳金鑰要保密、密碼要夠強，keystore 要存在安全的地方。如果遺失或外洩，可以在 Play 管理中心申請重設上傳金鑰。

  • 目標 API 級別：從 2026 年 8 月 31 日起，新應用程式和更新必須以 Android 16（API 級別 36）以上為目標。請在 android/app/build.gradle 確認。
  • 版本代碼：每次上傳前都要調高。每個上傳過的套件都會用掉它的版本代碼，所以我們每次建置前都會先到 Play 管理中心查看目前最大的值。
  • 只送 release 版本：送往正式版的套件裡不能有偵錯選單、測試廣告 ID 或開發者捷徑。

WebView 裡會壞掉的地方，以及我們的處理方式

在瀏覽器裡跑得好好的遊戲，放進 App 後可能表現不同。以下是我們發布紀錄裡記下的問題，有官方文件解法的也一併列出。

Android 返回鍵

Capacitor 的 App 外掛有 backButton 事件。文件說明，監聽這個事件會停用返回鍵的預設行為，由你決定按下返回時要做什麼；它也提供 App.exitApp() 用來關閉 App。在 Velvet Pool 裡，我們讓返回鍵開啟暫停選單，而不是直接關掉遊戲。

暫停與恢復

同一個外掛會觸發 appStateChange、pause 和 resume 事件。玩家離開 App 時，用它們暫停遊戲、計時器和正在播放的廣告，回來時再乾淨地恢復。

localhost 上的偵錯開關

在 App 裡，Capacitor 是從本機位址載入遊戲。如果你的遊戲在 localhost 執行時會開啟偵錯工具，那在 App 裡也會開啟。我們的建置腳本會強制關掉這些開關，關不掉就拒絕建置。

廣告

我們的 App 不使用網站的廣告程式碼。在 Android 上，我們透過 Capacitor 外掛使用原生 AdMob SDK，測試期間用 Google 的示範廣告單元，只有正式版建置才換成 App 自己的廣告單元。

版面與存檔

在模擬器上，我們發現橫向時按鈕被切掉、長單字斷行很難看，這些在瀏覽器版都沒出現過。每個畫面都要在直向和橫向測過，也要確認關掉 App 再打開後進度還在。

看看 Ricopop，我們為 Google Play 封裝的另一款範本

步驟 3：Play 管理中心設定與商店資訊

在 Play 管理中心建立應用程式，然後逐項完成應用程式內容區塊。我們每款遊戲填過的表單有：隱私權政策、應用程式存取權、廣告、內容分級、目標對象、資料安全性、廣告 ID，以及政府、金融和健康相關聲明。

  • 內容分級：Google 規定所有應用程式都必須有 IARC 分級，沒有分級的會被移除。誠實填寫問卷就能取得。
  • 資料安全性：每個應用程式都必須填寫，不收集資料的也一樣。內容必須反映第三方 SDK（例如廣告 SDK）收集的資料，並附上隱私權政策連結。
  • 目標對象：依照你實際鎖定的玩家填寫。分級和目標對象是兩個獨立的答案。

商店資訊素材

  • 應用程式圖示：512 × 512 像素，32 位元 PNG，最大 1024 KB。
  • 主題圖片：1024 × 500 像素，JPEG 或不含 Alpha 通道的 24 位元 PNG。
  • 螢幕截圖：每種裝置類型至少 2 張、最多 8 張。遊戲類 Google 建議至少 3 張呈現實際遊戲畫面的截圖，16:9 橫向（至少 1920 × 1080）或 9:16 直向（至少 1080 × 1920）。
  • 簡短說明：最多 80 個字元。

步驟 4：先測試，再上正式版

我們的作業流程把內部測試排在最前面：用真實帳戶從 Play 安裝 App，先實際玩一遍。之後再把版本推到正式版，交給 Google 審查。

新個人帳戶的規定

Play 管理中心說明寫明，2023 年 11 月 13 日之後建立的個人開發人員帳戶，必須進行封閉測試，至少 12 位測試人員連續選擇加入至少 14 天。之後再從資訊主頁申請正式版存取權，回答有關封閉測試、應用程式和正式發布準備的問題。請把這兩週排進上市時程。

跟客戶回報時，各個狀態要分清楚：已上傳到測試群組、已送審、已核准、已在 Google Play 公開，是四個不同的時間點。我們自己的發布紀錄記的是送審日期，不是核准日期，本文也一樣。

範本包含哪些內容，以及我們能幫你做的部分

每個範本都附上可直接架設的遊戲資料夾、易讀的原始碼、使用手冊和 6 個月支援（加購延長後為 12 個月）。支援範圍包括安裝和使用我們提供的檔案，以及修正可重現的瑕疵。Android 封裝、原生廣告、SDK 整合和上架發布都是另外的服務。

如果你不想自己操作 Android Studio，把範本、商店帳戶規劃和截止日期寄給我們。開工前我們會回覆工作範圍、價格和時程。客製工作沒有公開價目表。

索取封裝遊戲上架 Google Play 的報價

常見問題

HTML5 遊戲上架 Google Play 要花多少錢？

Google 對開發人員帳戶收取一次性 25 美元註冊費。其他成本是遊戲授權、商店美術素材和你的時間；如果請別人封裝，就是一筆報價的服務費。

在 Google Play 發布一定要 12 位測試人員嗎？

只有 2023 年 11 月 13 日之後建立的個人開發人員帳戶需要。這類帳戶必須先進行封閉測試，至少 12 位測試人員選擇加入至少 14 天，才能申請正式版存取權。

要用 APK 還是 AAB？

AAB。從 2021 年 8 月起，Google Play 上的新應用程式都必須使用 Android App Bundle。APK 還是很適合把建置直接安裝到你自己的測試手機上。

App 能不能直接從我的網站載入遊戲？

我們不這樣做。我們把遊戲檔案包在 App 裡，所以能離線執行，也不依賴任何網站。Google 的垃圾內容政策也針對那些主要用途是未經擁有者許可、以 WebView 顯示網站的應用程式。

你們的範本可以直接上架 Google Play 嗎？

不行。它們是可直接架設的瀏覽器遊戲，商品頁面也註明不含原生 App 建置。你可以照上面的步驟自己封裝，或請我們報價代工。