Objava HTML5 igre na Google Playu s Capacitorom, korak po korak

Da biste HTML5 igru objavili na Google Playu, mapu igre omotate u nativni Android projekt pomoću Capacitora, u Android Studiju izgradite potpisani Android App Bundle, u Play Consoleu stvorite aplikaciju, ispunite njezine obrasce o sadržaju i učitajte paket na probnu stazu prije produkcije. Ako je vaš račun za razvojne programere osobni račun stvoren nakon 13. studenoga 2023., Google također traži zatvoreni test s najmanje 12 testera u trajanju od 14 dana prije nego što možete zatražiti produkciju.

Ovo smo radili s vlastitim igrama. U listopadu 2026. upakirali smo Ricopop i Velvet Pool s Capacitorom i poslali obje na produkcijski pregled Googlea, a s njima i našu akcijsku igru Little Ninja Dash. Ovaj vodič miješa ono što pišu službene stranice Capacitora, Androida i Play Consolea, pročitane 30. listopada 2026., s onim što bilježe naše vlastite bilješke o izdanjima. Pravila i zahtjevi se mijenjaju, pa provjerite svaku povezanu stranicu prije slanja.

Prije objave HTML5 igre na Google Playu

• Račun za razvojne programere na Google Playu. Google naplaćuje jednokratnu registracijsku naknadu od 25 USD i traži da svaki razvojni programer potvrdi identitet. Osobni računi također moraju potvrditi pristup Android uređaju putem mobilne aplikacije Play Console prije objave.
• Node.js i Android Studio. Capacitorova dokumentacija za Android kaže da se Capacitor Android aplikacije konfiguriraju i upravljaju kroz Android Studio.
• Igra koja radi offline iz vlastite mape, s index.html u korijenu.
• Licenca za igru. Uz naše predloške, jedna licenca pokriva jedan krajnji proizvod i tu igru smijete objaviti gdje želite, uključujući Google Play i App Store. Sam predložak ne smijete preprodavati. Prije nego što dodate cijenu ili kupnje unutar aplikacije, pitajte nas, jer naši uvjeti govore o tome da igrači pristupaju proizvodu besplatno ili uz oglase.

Naša izdanja predložaka su igre za preglednik. Stranica svakog izdanja navodi da nativne aplikacije nisu uključene, pa su koraci u nastavku posao koji sami obavljate ili ga naručujete od nas po ponudi.

Pogledajte Velvet Pool, predložak bilijara koji smo također upakirali za Android

Korak 1: omotajte mapu igre s Capacitorom

Capacitoru treba package.json, mapa s izgrađenim web-datotekama i index.html u korijenu te mape. Njegova stranica za početak upozorava da index.html mora imati oznaku head ili dodaci neće raditi. Preuzeti HTML5 predložak obično već ima mapu: u našem je to game/.

1. U novoj mapi projekta pokrenite npm i @capacitor/core i npm i -D @capacitor/cli.
2. Pokrenite npx cap init. Traži naziv aplikacije, identifikator aplikacije (obrnuta domena, primjerice com.vasastudio.vasaigra) i web mapu. Usmjerite webDir na mapu igre.
3. Pokrenite npm i @capacitor/android, zatim npx cap add android. Time se stvara projekt android/.
4. Pokrenite npx cap sync svaki put kada promijenite datoteke igre. Naredba ih kopira u nativni projekt.
5. Pokrenite npx cap open android da otvorite projekt u Android Studiju.

Capacitorova dokumentacija kaže da je podržan API 24 i noviji, odnosno Android 7 i noviji. Naši Android projekti koriste taj minimum.

Mi radimo drugačije: nativni projekt držimo u zasebnom radnom prostoru mobile/ koji kopira igru u vlastitu web-mapu. Web-verzija ostaje netaknuta, a sve što pripada samo aplikaciji, poput nativnih oglasa, nalazi se u radnom prostoru.

Korak 2: izgradite i potpišite paket aplikacije

Od kolovoza 2021. nove aplikacije na Google Playu moraju se objavljivati kao Android App Bundle (AAB), a ne kao APK. U Android Studiju koristite Build, zatim Generate Signed Bundle/APK, odaberite Android App Bundle i stvorite ili odaberite keystore.

Taj keystore sadrži vaš ključ za učitavanje. Googleova stranica o potpisivanju aplikacija objašnjava da s Play App Signingom, koji nove aplikacije moraju postaviti pri prvoj objavi, Google čuva ključ za potpisivanje aplikacije, a vi svaki učitani paket potpisujete ključem za učitavanje. Držite ključ za učitavanje tajnim, birajte jake lozinke i keystore čuvajte na sigurnom mjestu. Ako se izgubi ili ugrozi, Play Console omogućuje zahtjev za resetiranje ključa za učitavanje.

• Ciljna razina API-ja: od 31. kolovoza 2026. nove aplikacije i ažuriranja moraju ciljati Android 16 (razina API-ja 36) ili višu. Provjerite cilj u android/app/build.gradle.
• Kod verzije: povećajte ga prije svakog učitavanja. Svaki paket koji učitate troši svoj kod verzije, pa prije svake gradnje čitamo najviši broj u Play Consoleu.
• Samo release gradnja: u paketu koji šaljete u produkciju nema izbornika za otklanjanje grešaka, testnih ID-ova oglasa ni prečaca za razvojne programere.

Što se lomi u webviewu i što smo s tim napravili

Igra koja dobro radi u pregledniku može se u aplikaciji ponašati drugačije. Ovo su problemi koje su zabilježile naše bilješke o izdanjima, uz dokumentirano rješenje tamo gdje ono postoji.

Gumb za povratak na Androidu

Capacitorov dodatak App ima događaj backButton. Njegova dokumentacija kaže da slušanje tog događaja isključuje zadano ponašanje gumba za povratak, pa sami odlučujete što povratak radi, a nudi i App.exitApp() za zatvaranje aplikacije. U Velvet Poolu povratak otvara izbornik pauze umjesto da zatvori igru.

Pauza i nastavak

Isti dodatak šalje događaje appStateChange, pause i resume. Koristite ih da pauzirate igru, mjerače vremena i svaki oglas koji radi kada igrač napusti aplikaciju te da se čisto nastavi.

Prečaci za otklanjanje grešaka na localhostu

U aplikaciji Capacitor poslužuje igru s lokalne adrese. Ako vaša igra uključuje alate za otklanjanje grešaka kada radi na localhostu, uključit će se i u aplikaciji. Naše skripte za gradnju te zastavice isključuju i odbijaju gradnju ako to ne mogu.

Oglasi

Oglasni kod za web-stranice nije ono što koristimo unutar naših aplikacija. Na Androidu koristimo nativni AdMob SDK preko Capacitor dodatka, uz Googleove demo jedinice oglasa tijekom testiranja i vlastite jedinice aplikacije samo u produkcijskoj gradnji.

Raspored i spremanje

Na emulatoru smo našli gumbe odrezane u vodoravnom prikazu i duge riječi koje se loše lome, što verzija za preglednik nije pokazala. Testirajte svaki ekran u oba smjera i provjerite da napredak preživi zatvaranje i ponovno otvaranje aplikacije.

Pogledajte Ricopop, još jedan predložak koji smo upakirali za Google Play

Korak 3: postavljanje Play Consolea i stranice u trgovini

Stvorite aplikaciju u Play Consoleu, zatim prođite kroz odjeljak sadržaja aplikacije. Obrasci koje smo ispunili za svaku igru bili su: pravilo o privatnosti, pristup aplikaciji, oglasi, ocjena sadržaja, ciljna publika, Data safety, ID oglašavanja te izjave o vladinim, financijskim i zdravstvenim podacima.

• Ocjena sadržaja: Google kaže da sve aplikacije moraju imati IARC ocjenu, a aplikacije bez nje bit će uklonjene. Dobivate je iskrenim odgovaranjem na upitnik.
• Data safety: svaka aplikacija mora ga ispuniti, uključujući aplikacije koje ne prikupljaju podatke. Mora odražavati podatke koje prikupljaju SDK-ovi trećih strana, poput oglasnog SDK-a, i treba imati poveznicu na pravilo o privatnosti.
• Ciljna publika: odgovorite za igrače kojima se stvarno obraćate. Ocjena i publika su zasebni odgovori.

Grafika stranice u trgovini

• Ikona aplikacije: 512 × 512 piksela, 32-bitni PNG, do 1024 KB.
• Istaknuta grafika: 1024 × 500 piksela, JPEG ili 24-bitni PNG bez alfa kanala.
• Snimke zaslona: najmanje dvije, do osam po vrsti uređaja. Za igre Google preporučuje najmanje tri snimke u vodoravnom formatu 16:9 (najmanje 1920 × 1080) ili uspravnom 9:16 (najmanje 1080 × 1920) koje prikazuju pravu igru.
• Kratki opis: do 80 znakova.

Korak 4: testiranje, zatim produkcija

Naš plan rada stavlja interno testiranje na prvo mjesto: instalirajte aplikaciju s Playa pravim računom i odigrajte je prije svega drugog. Zatim se izdanje promovira u produkciju, gdje prolazi Googleov pregled.

Pravilo za nove osobne račune

Stranica Play Console Help kaže da osobni razvojni računi stvoreni nakon 13. studenoga 2023. moraju voditi zatvoreni test s najmanje 12 testera koji su bili neprekidno uključeni najmanje 14 dana. Nakon toga zahtijevate pristup produkciji s Dashboarda i odgovarate na pitanja o zatvorenom testu, aplikaciji i spremnosti za produkciju. Ta dva tjedna uračunajte u datum lansiranja.

Kada izvještavate klijenta, držite stanja odvojeno: učitano na probnu stazu, poslano na pregled, odobreno i javno na Google Playu su četiri različita trenutka. Naše bilješke o izdanjima bilježe datume slanja, a ne datume odobrenja, i ovaj vodič također.

Što naši predlošci uključuju i dio koji možemo učiniti umjesto vas

Svaki predložak dolazi s gotovom mapom igre za postavljanje, čitljivim izvornim kodom, priručnikom i 6 mjeseci podrške, ili 12 uz proširenje. Podrška pokriva instalaciju i korištenje isporučenih datoteka te ispravljanje ponovljivih grešaka. Pakiranje za Android, nativni oglasi, integracija SDK-a i objava u trgovini zasebne su usluge.

Ako ne želite sami pokretati Android Studio, pošaljite nam predložak, plan računa za trgovinu i rok. Odgovorit ćemo s opsegom, cijenom i rokom prije bilo kakvog rada. Ne objavljujemo cjenik za prilagođeni rad.

Zatražite ponudu za pakiranje vaše igre za Google Play

Često postavljana pitanja

Koliko košta objava HTML5 igre na Google Playu?

Google naplaćuje jednokratnu registracijsku naknadu od 25 USD za račun razvojnog programera. Ostali troškovi su licenca za igru, grafika za trgovinu i vaše vrijeme ili usluga po ponudi ako pakiranje radi netko drugi.

Trebam li 12 testera za objavu na Google Playu?

Samo ako je vaš račun osobni račun za razvojne programere stvoren nakon 13. studenoga 2023. Ti računi moraju voditi zatvoreni test s najmanje 12 testera uključenih najmanje 14 dana prije zahtjeva za pristup produkciji.

APK ili AAB?

AAB. Nove aplikacije na Google Playu moraju koristiti Android App Bundle od kolovoza 2021. APK je i dalje koristan za izravnu instalaciju verzije na vlastiti testni telefon.

Može li aplikacija jednostavno učitati moju igru s moje web-stranice?

To ne radimo. Datoteke igre ugrađujemo u aplikaciju, pa radi offline i ne ovisi o web-stranici. Googleova pravila o neželjenom sadržaju također ciljaju aplikacije čija je glavna svrha webview web-stranice bez dopuštenja vlasnika.

Jesu li vaši predlošci spremni za Google Play odmah?

Ne. To su igre za preglednik spremne za hosting, a stranice proizvoda navode da nativne verzije za aplikacije nisu uključene. Možete ih sami upakirati prema koracima iznad ili naručiti posao od nas po ponudi.