Terbitkan Permainan HTML5 di Google Play dengan Capacitor

Untuk menerbitkan permainan HTML5 di Google Play, anda membungkus folder permainan ke dalam projek Android natif dengan Capacitor, membina Android App Bundle bertandatangan dalam Android Studio, mencipta aplikasi dalam Play Console, menjawab borang kandungannya dan memuat naik bundle ke trek ujian sebelum pengeluaran. Jika akaun pembangun anda ialah akaun peribadi yang dicipta selepas 13 November 2023, Google juga mewajibkan ujian tertutup dengan sekurang-kurangnya 12 penguji selama 14 hari sebelum anda boleh memohon akses pengeluaran.

Kami sudah melakukannya dengan permainan kami sendiri. Pada Oktober 2026, kami membungkus Ricopop dan Velvet Pool dengan Capacitor dan menghantar kedua-duanya untuk semakan pengeluaran Google Play, begitu juga permainan aksi kami, Little Ninja Dash. Panduan ini menggabungkan apa yang dinyatakan oleh halaman rasmi Capacitor, Android dan Play Console, dibaca pada 30 Oktober 2026, dengan apa yang direkodkan dalam nota keluaran kami. Peraturan dan keperluan berubah, jadi semak setiap halaman yang dipautkan sebelum anda menghantar.

Sebelum anda menerbitkan permainan HTML5 di Google Play

• Akaun pembangun Google Play. Google mengenakan yuran pendaftaran sekali bayar sebanyak US$25 dan meminta setiap pembangun mengesahkan identiti. Akaun peribadi juga mesti mengesahkan akses kepada peranti Android menggunakan aplikasi mudah alih Play Console sebelum menerbitkan.
• Node.js dan Android Studio. Dokumentasi Android Capacitor menyatakan aplikasi Capacitor Android dikonfigurasi dan diurus melalui Android Studio.
• Permainan yang berfungsi di luar talian daripada foldernya sendiri, dengan index.html di akar folder.
• Lesen untuk permainan itu. Dengan templat kami, satu lesen meliputi satu produk akhir, dan anda boleh menerbitkan permainan itu di mana-mana sahaja, termasuk Google Play dan App Store. Anda tidak boleh menjual semula templat itu sendiri. Tanya kami sebelum anda meletakkan harga atau menambah pembelian dalam aplikasi, kerana terma kami menyebut pemain mengakses produk secara percuma atau melalui iklan.

Edisi templat kami ialah permainan pelayar. Setiap halaman edisi menyenaraikan binaan aplikasi natif sebagai tidak termasuk, jadi langkah di bawah ialah kerja yang anda lakukan sendiri, atau tempah daripada kami berdasarkan sebut harga.

Lihat Velvet Pool, templat pool yang turut kami bungkus untuk Android

Langkah 1: bungkus folder permainan dengan Capacitor

Capacitor memerlukan package.json, folder yang mengandungi fail web yang telah dibina dan index.html di akar folder itu. Halaman permulaannya memberi amaran bahawa index.html mesti ada tag head, jika tidak plugin tidak akan berfungsi. Templat HTML5 yang dimuat turun biasanya sudah ada folder ini: dalam templat kami namanya game/.

1. Dalam folder projek baharu, jalankan npm i @capacitor/core dan npm i -D @capacitor/cli.
2. Jalankan npx cap init. Ia akan bertanya nama aplikasi, ID aplikasi (domain terbalik, contohnya com.yourstudio.yourgame) dan folder web. Halakan webDir ke folder permainan anda.
3. Jalankan npm i @capacitor/android, kemudian npx cap add android. Ini mencipta projek android/.
4. Jalankan npx cap sync setiap kali anda mengubah fail permainan. Ia menyalin fail itu ke dalam projek natif.
5. Jalankan npx cap open android untuk membuka projek dalam Android Studio.

Dokumentasi Capacitor menyatakan API 24 dan ke atas, iaitu Android 7 dan ke atas, disokong. Projek Android kami menggunakan tahap minimum itu.

Apa yang kami lakukan secara berbeza: kami menyimpan projek natif dalam ruang kerja mobile/ yang berasingan, yang menyalin permainan ke dalam folder webnya sendiri. Versi laman web tidak terusik, dan apa-apa yang hanya milik aplikasi, seperti iklan natif, berada dalam ruang kerja itu.

Langkah 2: bina dan tandatangani app bundle

Sejak Ogos 2021, aplikasi baharu di Google Play mesti diterbitkan sebagai Android App Bundle (AAB), bukan APK. Dalam Android Studio, gunakan Build, kemudian Generate Signed Bundle/APK, pilih Android App Bundle dan cipta atau pilih keystore.

Keystore itu menyimpan kunci muat naik anda. Halaman tandatangan aplikasi Google menerangkan bahawa dengan Play App Signing, yang wajib disediakan oleh aplikasi baharu semasa penerbitan pertama, Google menyimpan kunci tandatangan aplikasi dan anda menandatangani setiap muat naik dengan kunci muat naik. Rahsiakan kunci muat naik, pilih kata laluan yang kukuh dan simpan keystore di tempat selamat. Jika ia hilang atau terdedah, Play Console membolehkan anda memohon penetapan semula kunci muat naik.

• Tahap API sasaran: mulai 31 Ogos 2026, aplikasi baharu dan kemas kini mesti menyasarkan Android 16 (tahap API 36) atau lebih tinggi. Semak sasaran dalam android/app/build.gradle.
• Kod versi: naikkan sebelum setiap muat naik. Setiap bundle yang anda muat naik menggunakan kod versinya, jadi kami membaca nombor tertinggi dalam Play Console sebelum setiap binaan.
• Binaan release sahaja: tiada menu nyahpepijat, ID iklan ujian atau pintasan pembangun dalam bundle yang anda hantar ke pengeluaran.

Apa yang rosak di dalam webview, dan apa yang kami buat

Permainan yang berjalan lancar dalam pelayar boleh berkelakuan lain di dalam aplikasi. Inilah isu yang direkodkan dalam nota keluaran kami, bersama pembetulan yang didokumenkan jika ada.

Butang kembali Android

Plugin App Capacitor ada acara backButton. Dokumentasinya menyatakan bahawa mendengar acara ini akan mematikan kelakuan lalai butang kembali, jadi anda yang menentukan apa yang berlaku, dan ia menyediakan App.exitApp() untuk menutup aplikasi. Dalam Velvet Pool, kami jadikan butang kembali membuka menu jeda dan bukannya menutup permainan.

Jeda dan sambung semula

Plugin yang sama mencetuskan acara appStateChange, pause dan resume. Gunakannya untuk menjeda permainan, pemasa dan sebarang iklan yang sedang dimainkan apabila pemain keluar dari aplikasi, dan menyambung semula dengan kemas.

Pintasan nyahpepijat di localhost

Di dalam aplikasi, Capacitor menghidangkan permainan daripada alamat setempat. Jika permainan anda menghidupkan alat nyahpepijat apabila berjalan di localhost, alat itu juga akan hidup dalam aplikasi. Skrip binaan kami memaksa bendera itu dimatikan dan enggan membina jika tidak dapat.

Iklan

Kod iklan laman web bukan apa yang kami gunakan di dalam aplikasi kami. Di Android, kami menggunakan AdMob SDK natif melalui plugin Capacitor, dengan unit iklan demo Google semasa ujian dan unit aplikasi itu sendiri hanya dalam binaan pengeluaran.

Susun atur dan simpanan

Dalam emulator, kami mendapati butang terpotong dalam mod landskap dan perkataan panjang terpecah dengan teruk, sesuatu yang tidak berlaku dalam versi pelayar. Uji setiap skrin dalam kedua-dua orientasi, dan pastikan kemajuan kekal selepas aplikasi ditutup dan dibuka semula.

Lihat Ricopop, satu lagi templat yang kami bungkus untuk Google Play

Langkah 3: persediaan Play Console dan halaman kedai

Cipta aplikasi dalam Play Console, kemudian lengkapkan bahagian kandungan aplikasi satu demi satu. Borang yang kami isi untuk setiap permainan ialah dasar privasi, akses aplikasi, iklan, penarafan kandungan, khalayak sasaran, Keselamatan data, ID pengiklanan dan perisytiharan kerajaan, kewangan serta kesihatan.

• Penarafan kandungan: Google menyatakan semua aplikasi mesti ada penarafan IARC, dan aplikasi tanpanya akan dibuang. Anda mendapatkannya dengan menjawab soal selidik secara jujur.
• Keselamatan data: setiap aplikasi mesti melengkapkannya, termasuk aplikasi yang tidak mengumpul data. Ia mesti mencerminkan data yang dikumpul oleh SDK pihak ketiga, seperti SDK iklan, dan memerlukan pautan dasar privasi.
• Khalayak sasaran: jawab berdasarkan pemain yang benar-benar anda sasarkan. Penarafan dan khalayak ialah jawapan yang berasingan.

Aset halaman kedai

• Ikon aplikasi: 512 x 512 piksel, PNG 32-bit, sehingga 1024 KB.
• Grafik ciri: 1024 x 500 piksel, JPEG atau PNG 24-bit tanpa alfa.
• Tangkapan skrin: sekurang-kurangnya dua, sehingga lapan bagi setiap jenis peranti. Untuk permainan, Google mengesyorkan sekurang-kurangnya tiga tangkapan landskap 16:9 (sekurang-kurangnya 1920 x 1080) atau potret 9:16 (sekurang-kurangnya 1080 x 1920) yang menunjukkan permainan sebenar.
• Penerangan ringkas: sehingga 80 aksara.

Langkah 4: ujian, kemudian pengeluaran

Prosedur kami meletakkan ujian dalaman di tempat pertama: pasang aplikasi dari Play dengan akaun sebenar dan mainkannya sebelum yang lain. Kemudian keluaran dinaikkan ke pengeluaran, di mana ia melalui semakan Google.

Peraturan untuk akaun peribadi baharu

Play Console Help Google menyatakan akaun pembangun peribadi yang dicipta selepas 13 November 2023 mesti menjalankan ujian tertutup dengan minimum 12 penguji yang telah menyertai secara berterusan sekurang-kurangnya 14 hari. Selepas itu, anda memohon akses pengeluaran dari Papan Pemuka dan menjawab soalan tentang ujian tertutup, aplikasi dan kesediaannya untuk pengeluaran. Masukkan dua minggu ini dalam tarikh pelancaran anda.

Asingkan setiap status apabila melapor kepada pelanggan: dimuat naik ke trek ujian, dihantar untuk semakan, diluluskan dan tersedia awam di Google Play ialah empat detik yang berbeza. Nota keluaran kami merekod tarikh penghantaran, bukan tarikh kelulusan, dan begitu juga panduan ini.

Apa yang termasuk dalam templat kami, dan bahagian yang boleh kami lakukan untuk anda

Setiap templat disertakan dengan folder permainan yang sedia dihoskan, kod sumber yang mudah dibaca, manual dan sokongan 6 bulan, atau 12 bulan dengan lanjutan. Sokongan meliputi pemasangan dan penggunaan fail yang dibekalkan serta pembetulan kecacatan yang boleh dihasilkan semula. Pembungkusan untuk Android, iklan natif, integrasi SDK dan penerbitan di kedai ialah perkhidmatan berasingan.

Jika anda tidak mahu mengendalikan Android Studio sendiri, hantar kepada kami templat, rancangan akaun kedai dan tarikh akhir. Kami akan membalas dengan skop, harga dan tempoh sebelum sebarang kerja. Kami tidak menerbitkan senarai harga untuk kerja tempahan.

Minta sebut harga untuk membungkus permainan anda bagi Google Play

Soalan lazim

Berapakah kos untuk menerbitkan permainan HTML5 di Google Play?

Google mengenakan yuran pendaftaran sekali bayar US$25 untuk akaun pembangun. Kos lain anda ialah lesen permainan, grafik kedai dan masa anda, atau perkhidmatan bersebut harga jika orang lain melakukan pembungkusan.

Adakah saya perlukan 12 penguji untuk menerbitkan di Google Play?

Hanya jika akaun anda ialah akaun pembangun peribadi yang dicipta selepas 13 November 2023. Akaun ini mesti menjalankan ujian tertutup dengan sekurang-kurangnya 12 penguji yang menyertai sekurang-kurangnya 14 hari sebelum memohon akses pengeluaran.

APK atau AAB?

AAB. Aplikasi baharu di Google Play wajib menggunakan Android App Bundle sejak Ogos 2021. APK masih berguna untuk memasang binaan terus pada telefon ujian anda sendiri.

Bolehkah aplikasi hanya memuatkan permainan daripada laman web saya?

Kami tidak berbuat begitu. Kami membungkus fail permainan di dalam aplikasi supaya ia berfungsi di luar talian dan tidak bergantung pada laman web. Dasar spam Google juga menyasarkan aplikasi yang tujuan utamanya memaparkan laman web dalam webview tanpa kebenaran pemiliknya.

Adakah templat anda sedia untuk Google Play sebaik sahaja dibeli?

Tidak. Ia ialah permainan pelayar yang sedia dihoskan, dan halaman item menyatakan binaan aplikasi natif tidak termasuk. Anda boleh membungkusnya sendiri dengan langkah di atas atau menempah kerja itu daripada kami berdasarkan sebut harga.