HTML5 játék feltöltése Google Playre Capacitorral, lépésről lépésre

Ha HTML5 játékot szeretnél közzétenni a Google Playen, a játékmappát Capacitorral egy natív Android-projektbe csomagolod, Android Studióban egy aláírt Android App Bundle-t (AAB) építesz, létrehozod az appot a Play Console-ban, kitöltöd a tartalmi űrlapjait, és a bundle-t egy teszt csatornára töltöd fel az éles kiadás előtt. Ha a fejlesztői fiókod 2023. november 13. után létrehozott személyes fiók, a Google azt is megköveteli, hogy legalább 12 tesztelővel legyen egy zárt teszt 14 napon át, mielőtt éles hozzáférést kérhetsz.

Saját játékainkkal csináltuk ezt. 2026 októberében a Ricopop-ot és a Velvet Pool-t Capacitorral csomagoltuk be, és mindkettőt az éles Google Play felülvizsgálatra küldtük, a Little Ninja Dash akciójátékunkat pedig szintén. Ez az útmutató a hivatalos Capacitor-, Android- és Play Console-oldalakat keveri össze, amelyeket 2026. október 30-án olvastunk, azzal, amit a saját kiadási jegyzeteink rögzítettek. A szabályok és követelmények változnak, ezért mielőtt beküldesz, nézd meg minden linkelt oldalt.

Mielőtt HTML5 játékot teszel közzé a Google Playen

• Google Play fejlesztői fiók. A Google egyszeri 25 USD regisztrációs díjat kér, és minden fejlesztőtől azonosságának ellenőrzését várja. A személyes fiókoknak a közzététel előtt a Play Console mobilalkalmazással egy Android-eszközhöz való hozzáférést is igazolniuk kell.
• Node.js és Android Studio. A Capacitor Androidos dokumentációja szerint a Capacitor Android-appokat Android Studióban konfigurálod és kezeled.
• Olyan játék, amely offline működik a saját mappájából, gyökérben lévő index.html-lel.
• Licenc a játékra. A mi sablonjainknál egy licenc egy végtermékre szól, és a játékot bárhol közzéteheted, a Google Playt és az App Store-t is beleértve. Magát a sablont nem adhatod tovább. Mielőtt árat vagy alkalmazáson belüli vásárlást adsz hozzá, kérdezz nálunk, mert a feltételeink szerint a játékosok ingyen vagy reklámbevétellel érhetik el a terméket.

A sablonjaink böngészős játékok. Minden kiadás oldalán az szerepel, hogy a natív alkalmazásbuildek nincsenek benne, így az alábbi lépések olyan munka, amelyet te végzel, vagy amelyet árajánlat alapján rendelsz tőlünk.

Nézd meg a Velvet Pool-t, a pool sablont, amelyet Androidra is becsomagoltunk

1. lépés: a játékmappa becsomagolása Capacitorral

A Capacitornak kell egy package.json, egy mappa a lebuildelt webes fájlokkal, és egy index.html a mappa gyökerében. Az első lépések oldala figyelmeztet, hogy az index.html-nek kell egy head tag-je, különben a bővítmények nem működnek. A letöltött HTML5 sablonban ez a mappa általában már megvan: a mienkben ez a game/.

1. Egy új projektmappában futtasd az npm i @capacitor/core és az npm i -D @capacitor/cli parancsokat.
2. Futtasd az npx cap init parancsot. Kéri az alkalmazás nevét, az app ID-t (fordított domainnév, például com.yourstudio.yourgame) és a webmappát. A webDir a játékmappádra mutasson.
3. Futtasd az npm i @capacitor/android, majd az npx cap add android parancsot. Ez létrehozza az android/ projektet.
4. Minden játékfájl-változtatás után futtasd az npx cap sync parancsot. Ez másolja őket a natív projektbe.
5. Az npx cap open android paranccsal nyisd meg a projektet Android Studióban.

A Capacitor dokumentációja szerint az API 24-es és újabb szint, vagyis az Android 7 és újabb támogatott. Az Android-projektjeink ezt a minimumot használják.

Mi másképp csináljuk: a natív projektet egy külön mobile/ munkaterületen tartjuk, amely a játékot a saját webmappájába másolja. A webes verzió érintetlen marad, az csak az appra tartozó dolgok, például a natív reklámok, a munkaterületben laknak.

2. lépés: az app bundle építése és aláírása

2021 augusztusa óta a Google Playen az új appoknak Android App Bundle (AAB) formátumban kell megjelenniük, nem APK-ként. Android Studióban használd a Build, majd a Generate Signed Bundle/APK menüpontot, válaszd az Android App Bundle opciót, és hozz létre vagy válassz egy keystore-t.

Ez a keystore tartja a feltöltési kulcsodat. A Google aláíró oldala elmagyarázza, hogy a Play App Signing mellett, amelyet az új appoknak az első közzétételkor be kell állítaniuk, a Google az alkalmazás aláírókulcsát őrzi, te pedig minden feltöltést a feltöltési kulccsal írsz alá. A feltöltési kulcsot tartsd titokban, válassz erős jelszavakat, és a keystore-t tárold biztonságos helyen. Ha elveszik vagy kompromittálódik, a Play Console kérhet feltöltési kulcs-visszaállítást.

• Célzott API-szint: 2026. augusztus 31-től az új appoknak és frissítéseknek az Android 16-ot (API 36) vagy magasabbat kell célozniuk. A célt az android/app/build.gradle fájlban ellenőrizd.
• Verziókód: minden feltöltés előtt emeld. Minden feltöltött bundle felhasználja a verziókódját, ezért minden build előtt a Play Console-ban a legmagasabb számot olvassuk ki.
• Csak release build: a termelésbe küldött bundle-ben nincs fejlesztői menü, teszt hirdetési azonosító vagy fejlesztői gyorsbillentyű.

Ami webview-ben elromlik, és mit tettünk ellene

Egy játék, amely a böngészőben jól fut, az alkalmazásban másképp viselkedhet. Ezek azok a problémák, amelyeket a kiadási jegyzeteink rögzítettek, a dokumentált javítással, ahol van ilyen.

Az Android vissza gomb

A Capacitor App bővítményének van egy backButton eseménye. A dokumentációja szerint ennek figyelése kikapcsolja az alapértelmezett vissza gomb viselkedését, így te döntöd el, mit csináljon a vissza gomb, és van egy App.exitApp() metódusa az alkalmazás bezárására. A Velvet Pool-ban úgy állítottuk be, hogy a vissza gomb a szünet menüt nyissa meg a játék bezárása helyett.

Szünet és folytatás

Ugyanez a bővítmény az appStateChange, pause és resume eseményeket adja. Ezekkel állítsd meg a játékot, az időzítőket és a futó reklámot, amikor a játékos kilép az alkalmazásból, és tisztán folytasd, amikor visszajön.

Hibakereső gyorsbillentyűk localhoston

Az alkalmazáson belül a Capacitor a játékot helyi címről szolgálja ki. Ha a játékod localhoston bekapcsolja a hibakereső eszközöket, az alkalmazásban is bekapcsolnak. A build szkriptjeink ezeket a jelzőket kikapcsolva tartják, és nem építenek, ha ezt nem tudják megtenni.

Reklámok

Az appjainkon belül nem a weboldali reklámkódot használjuk. Androidon a natív AdMob SDK-t használjuk egy Capacitor bővítményen keresztül: tesztelés közben a Google demó hirdetési egységeit, az éles buildben pedig az app saját egységeit.

Elrendezés és mentés

Az emulátoron fekvő tájolásban levágott gombokat és rosszul törő hosszú szavakat láttunk, amelyeket a böngészős verzió nem mutatott. Minden képernyőt teszteld mindkét tájolásban, és ellenőrizd, hogy a haladás túléli-e az app bezárását és újranyitását.

Nézd meg a Ricopop-ot, egy másik sablont, amelyet Google Playre csomagoltunk

3. lépés: Play Console beállítás és áruházi lista

Hozd létre az appot a Play Console-ban, majd dolgozd végig az alkalmazás tartalma részt. Minden játékhoz a következő űrlapokat töltöttük ki: adatvédelmi szabályzat, alkalmazás-hozzáférés, reklámok, tartalmi besorolás, célközönség, Adatbiztonság (Data safety), a hirdetési azonosító, valamint a kormányzati, pénzügyi és egészségügyi nyilatkozatok.

• Tartalmi besorolás: a Google szerint minden appnak kell egy IARC-besorolás, a besorolás nélküli appokat eltávolítják. Ezt úgy kapod meg, hogy őszintén válaszolsz a kérdőívre.
• Adatbiztonság: minden appnak ki kell töltenie, akkor is, ha nem gyűjt adatot. Tükröznie kell a harmadik fél SDK-k, például egy reklám SDK által gyűjtött adatokat, és kell hozzá adatvédelmi szabályzat-link.
• Célközönség: a valódi játékosaidra válaszolj. A besorolás és a célközönség külön válaszok.

Áruházi lista anyagai

• App ikon: 512 × 512 pixel, 32 bites PNG, legfeljebb 1024 KB.
• Kiemelt grafika: 1024 × 500 pixel, JPEG vagy alfa nélküli 24 bites PNG.
• Képernyőképek: legalább kettő, eszköztípusonként legfeljebb nyolc. Játékoknál a Google legalább három 16:9-es fekvő (legalább 1920 × 1080) vagy 9:16-os álló (legalább 1080 × 1920) felvételt javasol, amelyek valódi játékmenetet mutatnak.
• Rövid leírás: legfeljebb 80 karakter.

4. lépés: tesztelés, majd éles kiadás

A kiadási runbookunk először belső tesztelést kér: telepítsd az appot a Play-ről valódi fiókkal, és játszd végig, mielőtt bármi mást csinálnál. Utána a kiadást éles csatornára léptetik elő, ahol a Google felülvizsgálata következik.

Az új személyes fiókok szabálya

A Play Console súgója szerint a 2023. november 13. után létrehozott személyes fejlesztői fiókoknak legalább 12 tesztelővel zárt tesztet kell futtatniuk, akik legalább 14 napon át folyamatosan be vannak jelentkezve. Ez után a Dashboardról kérhetsz éles hozzáférést, és válaszolsz a zárt tesztről, az appról és az éles felkészültségről szóló kérdésekre. Ezt a két hetet tervezd bele az indulási dátumba.

Ügyfélnek jelentéskor tartsd külön az állapotokat: tesztcsatornára feltöltve, felülvizsgálatra beküldve, jóváhagyva és nyilvánosan elérhetően a Google Playen négy különböző pillanat. A kiadási jegyzeteink a beküldés dátumait rögzítik, nem a jóváhagyásét, és ez az útmutató is így tesz.

Mit tartalmaznak a sablonjaink, és mit vállalhatunk el helyetted

Minden sablon a kész, tárhelyre feltölthető játékmappával, olvasható forráskóddal, kézikönyvvel és 6 hónap támogatással érkezik, a bővítménnyel 12 hónappal. A támogatás a mellékelt fájlok telepítését és használatát, valamint a reprodukálható hibák javítását fedi. Az Android-csomagolás, a natív reklámok, az SDK-integráció és az áruházi közzététel külön szolgáltatások.

Ha nem akarod magad futtatni az Android Studiót, küldd el nekünk a sablont, a store-fiók csomagját és a határidőt. Mielőtt bármi munka indulna, válaszolunk a terjedelemmel, az árral és az időzítéssel. Egyedi munkák árait nem közöljük nyilvános árlistán.

Kérj árajánlatot, hogy a játékodat Google Playre csomagoljuk

Gyakran ismételt kérdések

Mennyibe kerül HTML5 játékot közzétenni a Google Playen?

A Google egyszeri 25 USD regisztrációs díjat kér a fejlesztői fiókért. További költségek a játéklicenc, az áruházi grafika és a te időd, vagy ha valaki más csomagolja be, az árajánlat szerinti díj.

Kell 12 tesztelő a Google Playen való közzétételhez?

Csak akkor, ha a fiókod 2023. november 13. után létrehozott személyes fejlesztői fiók. Ezeknek legalább 12 tesztelővel zárt tesztet kell futtatniuk, akik legalább 14 napig be vannak jelentkezve, mielőtt éles hozzáférést kérnének.

APK vagy AAB?

AAB. Az új appoknak 2021 augusztusa óta Android App Bundle-t kell használniuk a Google Playen. Az APK továbbra is hasznos, ha egy buildet közvetlenül a saját teszttelefonodra telepítesz.

Az app csak a weboldaladról töltheti be a játékot?

Mi ezt nem csináljuk. A játékfájlokat az appba csomagoljuk, hogy offline működjön, és ne függjön egy oldaltól. A Google spam-szabályzata azokat az appokat is célba veszi, amelyek fő célja egy weboldal webview-ja a tulajdonos engedélye nélkül.

Készen állnak a sablonjaid Google Playre a dobozból?

Nem. Böngészős játékok, tárhelyre készen, a termékoldalak pedig jelzik, hogy natív alkalmazásbuildek nincsenek bennük. A fenti lépésekkel magad is becsomagolhatod őket, vagy árajánlat alapján megrendelheted tőlünk a munkát.