Publish ng HTML5 Game sa Google Play Gamit ang Capacitor, Hakbang-hakbang

Para mag-publish ng HTML5 game sa Google Play, binabalot mo ang game folder sa native na Android project gamit ang Capacitor, bumubuo ng signed na Android App Bundle sa Android Studio, gumagawa ng app sa Play Console, sinasagot ang content forms nito, at ina-upload ang bundle sa test track bago ang production. Kung personal na account ang developer account mo na ginawa pagkatapos ng 13 Nobyembre 2023, humihingi rin ang Google ng closed test na may hindi bababa sa 12 tester sa loob ng 14 na araw bago ka makapag-apply para sa production.

Ginawa na namin ito sa sarili naming mga laro. Noong Oktubre 2026, binalot namin ang Ricopop at Velvet Pool gamit ang Capacitor at ipinadala ang dalawa sa production review ng Google Play, kasama ang action game namin na Little Ninja Dash. Pinaghahalo ng gabay na ito ang sinasabi ng opisyal na pahina ng Capacitor, Android at Play Console, na binasa noong 30 Oktubre 2026, at ang nakasulat sa sarili naming release notes. Nagbabago ang mga patakaran at kinakailangan, kaya tingnan ang bawat naka-link na pahina bago ka mag-submit.

Bago mag-publish ng HTML5 game sa Google Play

• Google Play developer account. Naniningil ang Google ng one-time na registration fee na US$25 at hinihingi sa bawat developer na i-verify ang pagkakakilanlan. Kailangan ding i-verify ng personal na account ang access sa Android device gamit ang Play Console mobile app bago mag-publish.
• Node.js at Android Studio. Sinasabi ng dokumentasyon ng Capacitor para sa Android na ang mga Capacitor Android app ay naka-configure at pinamamahalaan sa Android Studio.
• Larong gumagana offline mula sa sarili nitong folder, na may index.html sa root.
• Lisensya para sa laro. Sa mga template namin, isang lisensya ang sumasakop sa isang end product, at puwede mong ilathala ang larong iyon kahit saan, kasama ang Google Play at App Store. Hindi mo puwedeng i-resell ang mismong template. Magtanong muna sa amin bago magdagdag ng presyo o in-app purchases, dahil sa mga tuntunin namin ay nakasaad na libre o sa pamamagitan ng advertising ina-access ng player ang produkto.

Mga browser game ang mga edition ng template namin. Nakalista sa bawat edition page na hindi kasama ang native app build, kaya ang mga hakbang sa ibaba ay trabahong ikaw ang gagawa, o trabahong ipapa-order mo sa amin sa pamamagitan ng quote.

Tingnan ang Velvet Pool, ang pool template na ipinacking din namin para sa Android

Hakbang 1: balutin ang game folder gamit ang Capacitor

Kailangan ng Capacitor ng package.json, folder na may mga built web file, at index.html sa root ng folder na iyon. Nagbababala ang getting-started page nito na dapat may head tag ang index.html, kung hindi ay hindi gagana ang mga plugin. Kadalasan may folder na ang na-download na HTML5 template: sa amin ay game/.

1. Sa bagong project folder, patakbuhin ang npm i @capacitor/core at npm i -D @capacitor/cli.
2. Patakbuhin ang npx cap init. Hihingi ito ng pangalan ng app, app ID (reverse domain, halimbawa com.yourstudio.yourgame) at web folder. Ituro ang webDir sa game folder mo.
3. Patakbuhin ang npm i @capacitor/android, saka npx cap add android. Gagawa ito ng android/ project.
4. Patakbuhin ang npx cap sync sa tuwing binabago mo ang mga game file. Kinokopya nito ang mga ito sa native project.
5. Patakbuhin ang npx cap open android para buksan ang project sa Android Studio.

Sabi ng dokumentasyon ng Capacitor, suportado ang API 24 pataas, o Android 7 pataas. Ang mga Android project namin ay gumagamit ng minimum na iyan.

Iba ang ginagawa namin: pinananatili namin ang native project sa hiwalay na mobile/ workspace na kumokopya ng laro sa sarili nitong web folder. Hindi ginagalaw ang bersyon sa website, at ang anumang para lang sa app, gaya ng native ads, ay nasa workspace.

Hakbang 2: i-build at pirmahan ang app bundle

Mula Agosto 2021, ang mga bagong app sa Google Play ay dapat i-publish bilang Android App Bundles (AAB), hindi APK. Sa Android Studio, gamitin ang Build, saka Generate Signed Bundle/APK, piliin ang Android App Bundle at gumawa o pumili ng keystore.

Hawak ng keystore na iyon ang upload key mo. Ipinapaliwanag ng app-signing page ng Google na sa Play App Signing, na dapat i-set up ng mga bagong app sa unang publication, hawak ng Google ang app signing key at pinipirmahan mo ang bawat upload gamit ang upload key. Itago nang lihim ang upload key, gumamit ng malalakas na password at ilagay ang keystore sa ligtas na lugar. Kung mawala ito o ma-compromise, puwede kang humiling ng upload key reset sa Play Console.

• Target API level: mula 31 Agosto 2026, ang mga bagong app at update ay dapat mag-target ng Android 16 (API level 36) o mas mataas. Tingnan ang target sa android/app/build.gradle.
• Version code: itaas ito bago ang bawat upload. Nauubos ng bawat bundle na ina-upload mo ang version code nito, kaya binabasa namin ang pinakamataas sa Play Console bago ang bawat build.
• Release build lang: walang debug menu, test ad ID o developer shortcut sa bundle na ipinapadala mo sa production.

Ano ang nasisira sa loob ng webview, at ano ang ginawa namin

Ang larong maayos sa browser ay puwedeng kumilos nang iba sa loob ng app. Ito ang mga isyung naitala sa release notes namin, kasama ang dokumentadong ayos kung mayroon.

Ang back button ng Android

May backButton event ang App plugin ng Capacitor. Sabi ng dokumentasyon nito, kapag nakinig ka rito, nawawala ang default na kilos ng back button, kaya ikaw ang nagpapasya kung ano ang gagawin ng back, at may App.exitApp() para isara ang app. Sa Velvet Pool, ginawa naming buksan ng back ang pause menu sa halip na isara ang laro.

Pause at resume

Naglalabas din ng appStateChange, pause at resume events ang parehong plugin. Gamitin ang mga ito para i-pause ang laro, mga timer at anumang tumatakbong ad kapag umalis ang player sa app, at para maayos na mag-resume.

Mga debug shortcut sa localhost

Sa loob ng app, inihahain ng Capacitor ang laro mula sa lokal na address. Kung binubuksan ng laro mo ang debug tools kapag tumatakbo sa localhost, bubukas din ang mga iyon sa app. Pinapatay ng build script namin ang mga flag na iyon at tumatangging mag-build kapag hindi nila ito magawa.

Mga ad

Hindi ang website ad code ang ginagamit namin sa loob ng app. Sa Android, ginagamit namin ang native na AdMob SDK sa pamamagitan ng Capacitor plugin, na may demo ad unit ng Google habang nagte-test, at ang sariling ad unit ng app ay nasa production build lang.

Layout at pag-save

Sa emulator, may mga button na naputol sa landscape at mga mahabang salitang sira ang putol, na hindi ipinakita ng bersyon sa browser. Subukan ang bawat screen sa dalawang orientation, at tiyaking nananatili ang progress kapag isinara at binuksan ulit ang app.

Tingnan ang Ricopop, isa pang template na ipinacking namin para sa Google Play

Hakbang 3: setup ng Play Console at store listing

Gumawa ng app sa Play Console, saka tapusin ang app content section. Ang mga form na pinunan namin para sa bawat laro ay privacy policy, app access, ads, content rating, target audience, Data safety, advertising ID, at ang deklarasyon tungkol sa gobyerno, pinansiyal at kalusugan.

• Content rating: sabi ng Google, dapat may IARC rating ang lahat ng app, at tatanggalin ang mga walang nito. Makukuha ito sa pamamagitan ng tapat na pagsagot sa questionnaire.
• Data safety: dapat itong kumpletuhin ng bawat app, kasama ang mga app na walang kinokolektang data. Dapat nitong ipakita ang datos na kinokolekta ng third-party SDK, gaya ng ad SDK, at kailangan nito ng link sa privacy policy.
• Target audience: sumagot para sa mga player na talagang tinutukoy mo. Magkahiwalay na sagot ang rating at ang audience.

Mga asset ng store listing

• App icon: 512 by 512 pixels, 32-bit na PNG, hanggang 1024 KB.
• Feature graphic: 1024 by 500 pixels, JPEG o 24-bit na PNG na walang alpha.
• Screenshot: hindi bababa sa dalawa, hanggang walo bawat uri ng device. Para sa mga laro, inirerekomenda ng Google ang hindi bababa sa tatlong 16:9 landscape (hindi bababa sa 1920 by 1080) o 9:16 portrait (hindi bababa sa 1080 by 1920) na capture na nagpapakita ng totoong gameplay.
• Maikling paglalarawan: hanggang 80 karakter.

Hakbang 4: testing, saka production

Ang runbook namin ay nagsisimula sa internal testing: i-install ang app mula sa Play gamit ang totoong account at laruin ito bago ang lahat. Pagkatapos, ipo-promote ang release sa production, kung saan dadaan ito sa review ng Google.

Ang patakaran para sa bagong personal account

Sabi ng Play Console Help ng Google, ang personal developer account na ginawa pagkatapos ng 13 Nobyembre 2023 ay dapat magpatakbo ng closed test na may hindi bababa sa 12 tester na tuloy-tuloy na naka-opt in nang hindi bababa sa 14 na araw. Pagkatapos niyon, mag-a-apply ka para sa production access mula sa Dashboard at sasagot sa mga tanong tungkol sa closed test, sa app at sa kahandaan nito sa production. Isama ang dalawang linggong ito sa petsa ng launch mo.

Panatilihing hiwalay ang mga estado kapag nag-uulat ka sa kliyente: ang na-upload sa test track, na-submit para sa review, na-approve, at public na sa Google Play ay apat na magkakaibang sandali. Ang sarili naming release notes ay nagtatala ng petsa ng pag-submit, hindi ng approval, at ganoon din ang gabay na ito.

Ano ang kasama sa mga template namin, at ang bahaging kaya naming gawin para sa iyo

May kasamang handa-nang-i-host na game folder, nababasang source, manual at 6 na buwang support ang bawat template, o 12 kung may extension. Sakop ng support ang pag-install at paggamit ng mga ibinigay na file at ang pag-ayos ng mga defect na nauulit. Hiwalay na serbisyo ang packaging para sa Android, native ads, SDK integration at store publication.

Kung ayaw mong ikaw mismo ang magpatakbo ng Android Studio, ipadala sa amin ang template, ang plan ng store account at ang deadline. Sasagot kami ng saklaw, presyo at timing bago ang anumang trabaho. Hindi kami naglalathala ng price list para sa custom na trabaho.

Humingi ng quote para i-package ang laro mo para sa Google Play

Mga madalas itanong

Magkano ang gastos sa pag-publish ng HTML5 game sa Google Play?

Naniningil ang Google ng one-time na US$25 na registration fee para sa developer account. Ang iba mo pang gastos ay ang lisensya ng laro, ang store art at ang oras mo, o serbisyong may quote kung may ibang gagawa ng packaging.

Kailangan ko ba ng 12 tester para mag-publish sa Google Play?

Kung personal developer account ka na ginawa pagkatapos ng 13 Nobyembre 2023, oo. Kailangang magpatakbo ng closed test ang mga account na iyon na may hindi bababa sa 12 tester na naka-opt in nang hindi bababa sa 14 na araw bago mag-apply para sa production access.

APK o AAB?

AAB. Mula Agosto 2021, kailangang gumamit ng Android App Bundle ang mga bagong app sa Google Play. Kapaki-pakinabang pa rin ang APK para mag-install ng build nang direkta sa sarili mong test phone.

Puwede bang i-load lang ng app ang laro mula sa website ko?

Hindi namin ginagawa iyon. Isinasama namin ang mga game file sa loob ng app para gumana ito offline at hindi nakadepende sa site. Tinatarget din ng spam policy ng Google ang mga app na ang pangunahing layunin ay webview ng website nang walang pahintulot ng may-ari.

Handa na ba para sa Google Play ang mga template ninyo?

Hindi. Mga browser game ang mga ito na handa nang i-host, at nakasaad sa item pages na hindi kasama ang native app build. Puwede mo itong i-package sa sarili mo gamit ang mga hakbang sa itaas, o i-order ang trabaho sa amin sa pamamagitan ng quote.