HTML5-mängu avaldamine Google Plays Capacitoriga, samm-sammult

HTML5-mängu avaldamiseks Google Plays pakid mängukausta Capacitoriga natiivsesse Androidi projekti, koostad Android Studios allkirjastatud Android App Bundle'i, loood rakenduse Play Console'is, täidad selle sisuvormid ja laadid paketi enne tootmist testrajale. Kui su arendajakonto on isiklik ja loodud pärast 13. novembrit 2023, nõuab Google lisaks, et enne tootmise taotlemist käiks suletud test vähemalt 12 testijaga 14 päeva.

Oleme seda teinud oma mängudega. 2026. aasta oktoobris pakkisime Capacitoriga Ricopopi ja Velvet Poolit ning saatsime mõlemad Google Play tootmise ülevaatusele, samuti meie tegevusmängu Little Ninja Dash. See juhend segab ametlike Capacitori, Androidi ja Play Console'i lehtede sisu, loetud 30. oktoobril 2026, sellega, mida meie väljaande märkmed salvestavad. Reeglid ja nõuded muutuvad, seega kontrolli iga lingitud lehte enne esitamist.

Enne HTML5-mängu avaldamist Google Plays

• Google Play arendajakonto. Google võtab ühekordse registreerimistasu 25 $ ja nõuab, et iga arendaja tõendaks oma isikut. Isiklikud kontod peavad enne avaldamist tõendama ka juurdepääsu Androidi seadmele Play Console'i mobiilirakendusega.
• Node.js ja Android Studio. Capacitori Androidi dokumentatsioon ütleb, et Capacitori Androidi rakendusi seadistatakse ja hallatakse Android Studio kaudu.
• Mäng, mis töötab võrguühenduseta oma kaustast, juurkaustas index.html.
• Mängu litsents. Meie mallidega katab üks litsents ühte lõpptoodet ja selle mängu võid avaldada kus soovid, sealhulgas Google Plays ja App Store'is. Malli ennast edasi müüa ei tohi. Küsi meilt enne hinna või rakendusesisese ostu lisamist, sest meie tingimused räägivad sellest, et mängijad pääsevad tootele tasuta või reklaamide kaudu.

Meie mallide väljaanded on brauserimängud. Iga väljaande lehel on öeldud, et natiivsete rakenduste koostised ei ole kaasas, seega allpool toodud sammud on töö, mida teed sina või mille tellid meilt pakkumise alusel.

Vaata Velvet Poolit, bilardimalli, mille oleme pakkinud ka Androidile

1. samm: pakkige mängukaust Capacitoriga

Capacitor vajab faili package.json, kausta koostatud veebifailidega ja index.html-i selle kausta juurde. Selle alustamise lehel hoiatatakse, et index.html peab sisaldama head-silti, muidu pluginad ei tööta. Allalaaditud HTML5-mallil on kaust tavaliselt juba olemas: meie omas on see game/.

1. Uues projektikaustas käivita npm i @capacitor/core ja npm i -D @capacitor/cli.
2. Käivita npx cap init. See küsib rakenduse nime, rakenduse ID-d (pöörddomeen, näiteks com.yourstudio.yourgame) ja veebikausta. Suuna webDir oma mängukausta.
3. Käivita npm i @capacitor/android ja seejärel npx cap add android. See loob projekti android/.
4. Käivita npx cap sync iga kord, kui muudad mängufaile. See kopeerib need natiivsesse projekti.
5. Käivita npx cap open android, et avada projekt Android Studios.

Capacitori dokumentatsioon ütleb, et toetatud on API 24 ja uuemad, ehk Android 7 ja uuemad. Meie Androidi projektid kasutavad seda miinimumi.

Meie teeme teisiti: hoiame natiivset projekti eraldi töökeskkonnas mobile/, mis kopeerib mängu oma veebikausta. Veebiversioon jääb puutumata ja kõik, mis kuulub ainult rakendusse, näiteks natiivsed reklaamid, asub töökeskkonnas.

2. samm: koosta ja allkirjasta rakenduse pakett

Alates augustist 2021 tuleb Google Plays uusi rakendusi avaldada Android App Bundle'idena (AAB), mitte APK-dena. Android Studios ava menüü Build (koosta), vali Generate Signed Bundle/APK (genereeri allkirjastatud pakett/APK), vali Android App Bundle ja loo või vali keystore.

See keystore hoiab sinu üleslaadimisvõtit. Google'i rakenduse allkirjastamise lehel selgitatakse, et Play App Signingiga, mille uued rakendused peavad esimesel avaldamisel seadistama, hoiab Google rakenduse allkirjastamise võtit ja sina allkirjastad iga üleslaadimise üleslaadimisvõtmega. Hoia üleslaadimisvõti saladuses, vali tugevad paroolid ja hoia keystore turvalises kohas. Kui see kaob või satub valedesse kätesse, võimaldab Play Console taotleda üleslaadimisvõtme lähtestamist.

• Sihtmärgi API tase: alates 31. augustist 2026 peavad uued rakendused ja uuendused sihtima Android 16 (API tase 36) või kõrgemat. Kontrolli sihtmärki failis android/app/build.gradle.
• Versioonikood: tõsta seda enne iga üleslaadimist. Iga üleslaaditud pakett kasutab oma versioonikoodi ära, seega loeme enne iga koostamist Play Console'ist kõrgeima väärtuse.
• Ainult väljaandekoostis: tootmisesse saadetavas paketis ei ole silumismenüüd, testreklaamide ID-sid ega arendaja otseteid.

Mis puruneb webview'us ja mida selle vastu tegime

Brauseris hästi töötav mäng võib rakenduses käituda teisiti. Need on probleemid, mis meie väljaande märkmetes olid kirjas, koos dokumenteeritud lahendusega, kui see on olemas.

Androidi tagasinupp

Capacitori App-pluginal on backButton-sündmus. Selle dokumentatsioon ütleb, et selle kuulamine lülitab vaikimisi tagasinupu käitumise välja, seega otsustad ise, mida tagasi teeb, ja App.exitApp() sulgeb rakenduse. Velvet Poolis tegime nii, et tagasi avab pausimenüü, mitte ei sulge mängu.

Paus ja jätkamine

Sama plugin käivitab sündmused appStateChange, pause ja resume. Kasuta neid, et peatada mäng, taimerid ja mis tahes töötav reklaam, kui mängija rakendusest lahkub, ja jätkata puhtalt.

Silumisotseteed localhostis

Rakenduses serveerib Capacitor mängu kohaliku aadressi kaudu. Kui su mäng lülitab localhostis sisse silumistööriistad, lülituvad need sisse ka rakenduses. Meie koostamisskriptid lülitavad need lipud välja ja keelduvad koostamast, kui seda teha ei saa.

Reklaamid

Rakendustes ei kasuta me veebireklaamide koodi. Androidil kasutame natiivset AdMob SDK-d Capacitori plugina kaudu, testimise ajal Google'i demo-reklaamiüksusi ja rakenduse enda üksusi ainult tootmiskoostises.

Paigutus ja salvestamine

Emulaatoril leidsime horisontaalses režiimis lõigatud nupud ja pikad sõnad, mis katkesid halvasti, mida brauseriversioon ei näidanud. Testi iga ekraani mõlemas suunas ja kontrolli, et edusammud säilivad rakenduse sulgemisel ja uuesti avamisel.

Vaata Ricopopi, teist malli, mille oleme Google Play jaoks pakkinud

3. samm: Play Console'i seadistus ja poe nimekiri

Loo rakendus Play Console'is ja käi läbi jaotis App content (rakenduse sisu). Vormid, mille täitsime iga mängu jaoks, olid: privaatsuspoliitika, App access (rakenduse juurdepääs), reklaamid, Content rating (sisu hinnang), sihtrühm, Data safety (andmeohutus), reklaami ID ning valitsuse, finants- ja terviseteated.

• Sisu hinnang: Google ütleb, et kõigil rakendustel peab olema IARC-hinnang ja ilma selleta rakendused eemaldatakse. Selle saad, vastates küsimustikule ausalt.
• Andmeohutus: iga rakendus peab selle täitma, isegi kui rakendus ei kogu andmeid. See peab kajastama kolmandate osapoolte SDK-de, näiteks reklaam-SDK, kogutud andmeid ja vajab privaatsuspoliitika linki.
• Sihtrühm: vasta mängijatele, keda tegelikult sihid. Hinnang ja sihtrühm on eraldi vastused.

Poe nimekirja materjalid

• Rakenduse ikoon: 512 × 512 pikslit, 32-bitine PNG, kuni 1024 KB.
• Esiletõstegraafika: 1024 × 500 pikslit, JPEG või 24-bitine PNG ilma alfakanalita.
• Ekraanipildid: vähemalt kaks, kuni kaheksa seadmetüübi kohta. Mängude puhul soovitab Google vähemalt kolme 16:9 horisontaalset (vähemalt 1920 × 1080) või 9:16 vertikaalset (vähemalt 1080 × 1920) kaadrit, mis näitavad päris mängu.
• Lühikirjeldus: kuni 80 tähemärki.

4. samm: testimine ja seejärel tootmine

Meie töövihik paneb esimesena sisemise testimise: paigalda rakendus Google Playst päris kontoga ja mängi seda enne midagi muud. Seejärel viiakse väljaanne tootmisesse, kus see läbib Google'i ülevaatuse.

Reegel uutele isiklikele kontodele

Google Play Console'i abi ütleb, et isiklikud arendajakontod, mis on loodud pärast 13. novembrit 2023, peavad läbi viima suletud testi vähemalt 12 testijaga, kes on olnud pidevalt sisse lülitatud vähemalt 14 päeva. Pärast seda taotled tootmisligipääsu juhtpaneelilt (Dashboard) ja vastad küsimustele suletud testi, rakenduse ja tootmisvalmiduse kohta. Planeeri need kaks nädalat oma käivitamise kuupäeva.

Kliendile aruandes hoia olekud lahus: testrajale üleslaadimine, ülevaatusele esitamine, heakskiit ja avalik olek Google Plays on neli eri hetke. Meie oma väljaande märkmed salvestavad esitamise kuupäevi, mitte heakskiidu kuupäevi, ja nii teeb ka see juhend.

Mida meie mallid sisaldavad ja mida saame sinu heaks teha

Iga mall tuleb valmis majutatava mängukaustaga, loetava lähtekoodi, juhendi ja 6 kuu toega, või 12 kuuga laiendusega. Tugi hõlmab kaasasolevate failide paigaldamist ja kasutamist ning korduvate vigade parandamist. Androidi pakendamine, natiivsed reklaamid, SDK-integratsioon ja poes avaldamine on eraldi teenused.

Kui sa ei soovi Android Studiot ise kasutada, saada meile mall, poe konto plaan ja tähtaeg. Vastame ulatuse, hinna ja ajakava kohta enne mis tahes tööd. Kohandatud töö hinnakirja ei avalda.

Küsi pakkumist mängu pakkimiseks Google Plays

Korduma kippuvad küsimused

Kui palju maksab HTML5-mängu avaldamine Google Plays?

Google võtab arendajakonto eest ühekordse registreerimistasu 25 $. Muud kulud on mängu litsents, poe graafika ja sinu aeg või pakkimisteenus, kui selle teeb keegi teine.

Kas ma vajan Google Plays avaldamiseks 12 testijat?

Ainult siis, kui su konto on isiklik arendajakonto, loodud pärast 13. novembrit 2023. Sellised kontod peavad enne tootmisligipääsu taotlemist läbi viima suletud testi, kus on vähemalt 12 testijat, kes on sisse lülitatud vähemalt 14 päeva.

APK või AAB?

AAB. Uued rakendused Google Plays on pidanud olema Android App Bundle'ina alates augustist 2021. APK on endiselt kasulik koostise otseseks paigaldamiseks oma testtelefoni.

Kas rakendus saab lihtsalt laadida mängu mu veebilehelt?

Seda me ei tee. Pakime mängufailid rakenduse sisse, et see töötaks võrguühenduseta ja ei sõltuks saidist. Google'i rämpsposti poliitika sihib ka rakendusi, mille peamine eesmärk on veebisaidi webview ilma omaniku loata.

Kas sinu mallid on Google Plays kohe kasutatavad?

Ei. Need on brauserimängud, mis on valmis majutamiseks, ja toote lehtedel on öeldud, et natiivsete rakenduste koostised ei ole kaasas. Saad need ise pakkida ülaltoodud sammude järgi või tellida töö meilt pakkumise alusel.