HTML5 spēles publicēšana Google Play ar Capacitor, soli pa solim

Lai publicētu HTML5 spēli Google Play, spēles mapi ietiniet natīvā Android projektā ar Capacitor, Android Studio izveidojiet parakstītu Android App Bundle, Play Console izveidojiet lietotni, aizpildiet tās satura anketas un pirms produkcijas augšupielādējiet paketi testa kanālā. Ja jūsu izstrādātāja konts ir personīgs un izveidots pēc 2023. gada 13. novembra, Google prasa arī slēgtu testu ar vismaz 12 testētājiem 14 dienas, pirms var pieteikties produkcijai.

Esam to darījuši ar saviem spēlēm. 2026. gada oktobrī iepakojām Ricopop un Velvet Pool ar Capacitor un nosūtījām abas Google Play produkcijas pārskatīšanai, kā arī mūsu darbības spēli Little Ninja Dash. Šis ceļvedis apvieno to, ko saka oficiālās Capacitor, Android un Play Console lapas, lasītas 2026. gada 30. oktobrī, ar to, ko rāda mūsu pašu izlaišanas piezīmes. Noteikumi un prasības mainās, tāpēc pirms iesniegšanas pārbaudiet katru saiti.

Kas nepieciešams, lai publicētu HTML5 spēli Google Play

• Google Play izstrādātāja konts. Google ņem vienreizēju reģistrācijas maksu 25 USD un prasa, lai katrs izstrādātājs apliecina savu identitāti. Personīgajiem kontiem pirms publicēšanas jāpierāda piekļuve Android ierīcei ar Play Console mobilo lietotni.
• Node.js un Android Studio. Capacitor Android dokumentācija saka, ka Capacitor Android lietotnes konfigurē un pārvalda ar Android Studio.
• Spēle, kas darbojas bezsaistē no savas mapes, ar index.html saknē.
• Spēles licence. Ar mūsu sagatavēm viena licence sedz vienu gala produktu, un šo spēli varat publicēt jebkur, arī Google Play un App Store. Pašu sagatavi pārdot nedrīkstat. Pirms cenas vai lietotnes iekšpirkumu pievienošanas jautājiet mums, jo mūsu noteikumi runā par to, ka spēlētāji produktam piekļūst bez maksas vai caur reklāmām.

Mūsu sagatavju izdevumi ir pārlūka spēles. Katras izdevuma lapā norādīts, ka natīvo lietotņu būves nav iekļautas, tāpēc tālākie soļi ir darbs, ko veicat paši, vai darbs, ko pasūtāt pēc piedāvājuma.

Skatiet Velvet Pool, biljarda sagatavi, ko arī iepakojām Android

1. solis: ietiniet spēles mapi ar Capacitor

Capacitor vajag package.json, mapi ar izveidotajiem tīmekļa failiem un index.html šīs mapes saknē. Tā sākuma lapa brīdina, ka index.html jābūt head tagam, citādi spraudņi nedarbosies. Lejupielādēta HTML5 sagatave parasti jau ir šāda mape: mūsējā tā ir game/.

1. Jaunā projekta mapē palaidiet npm i @capacitor/core un npm i -D @capacitor/cli.
2. Palaidiet npx cap init. Tas prasa lietotnes nosaukumu, lietotnes ID (apgriezts domēns, piemēram, com.yourstudio.yourgame) un tīmekļa mapi. Norādiet webDir uz savu spēles mapi.
3. Palaidiet npm i @capacitor/android, tad npx cap add android. Tas izveido projektu android/.
4. Katru reizi, kad maināt spēles failus, palaidiet npx cap sync. Tas tos nokopē natīvajā projektā.
5. Palaidiet npx cap open android, lai atvērtu projektu Android Studio.

Capacitor dokumentācija saka, ka tiek atbalstīts API 24 un jaunāks, tas ir, Android 7 un jaunāks. Mūsu Android projekti izmanto šo minimumu.

Mēs darām citādi: natīvo projektu glabājam atsevišķā mobile/ darbvietā, kas nokopē spēli savā tīmekļa mapē. Tīmekļa versija paliek neskarta, un viss, kas pieder tikai lietotnei, piemēram, natīvās reklāmas, dzīvo darbvietā.

2. solis: būvējiet un parakstiet lietotnes paketi

Kopš 2021. gada augusta jaunām lietotnēm Google Play jāpublicē kā Android App Bundles (AAB), nevis APK. Android Studio izvēlieties Build, tad Generate Signed Bundle/APK, izvēlieties Android App Bundle un izveidojiet vai izvēlieties keystore.

Šajā keystore glabājas jūsu augšupielādes atslēga. Google lapa par parakstīšanu skaidro, ka ar Play App Signing, kas jauniem lietotnēm jāiestata pirmajā publicēšanā, Google glabā lietotnes parakstīšanas atslēgu, bet katru augšupielādi jūs parakstāt ar augšupielādes atslēgu. Glabājiet augšupielādes atslēgu slepenu, izvēlieties stiprās paroles un keystore glabājiet drošā vietā. Ja tā pazūd vai tiek apdraudēta, Play Console ļauj pieprasīt augšupielādes atslēgas atiestatīšanu.

• Mērķa API līmenis: no 2026. gada 31. augusta jaunām lietotnēm un atjauninājumiem jāmērķē uz Android 16 (API līmenis 36) vai augstāku. Pārbaudiet mērķi failā android/app/build.gradle.
• Versijas kods: paaugstiniet to pirms katras augšupielādes. Katrs augšupielādētais bundle izmanto savu versijas kodu, tāpēc pirms katras būves Play Console nolasām augstāko.
• Tikai release būve: paketē, ko sūtāt produkcijai, nav atkļūdošanas izvēlņu, testa reklāmu ID vai izstrādātāja īsceļu.

Ko webview salauž un ko mēs darījām

Spēle, kas labi darbojas pārlūkā, lietotnē var uzvesties citādi. Šeit ir problēmas, ko fiksēja mūsu izlaišanas piezīmes, kopā ar dokumentēto risinājumu, kur tāds pastāv.

Android atpakaļ poga

Capacitor App spraudnim ir backButton notikums. Tā dokumentācija saka, ka tā klausīšanās atspējo noklusēto atpakaļ pogas uzvedību, tāpēc lemjat jūs, ko dara atpakaļ, un piedāvā App.exitApp(), lai aizvērtu lietotni. Velvet Pool mēs panācām, ka atpakaļ atver pauzes izvēlni, nevis aizver spēli.

Pauze un atsākšana

Tas pats spraudnis izsauc appStateChange, pause un resume notikumus. Izmantojiet tos, lai apturētu spēli, taimerus un jebkuru darbojošos reklāmu, kad spēlētājs atstāj lietotni, un lai atsāktu tīri.

Atkļūdošanas īsceļi localhost

Lietotnē Capacitor pasniedz spēli no vietējas adreses. Ja jūsu spēle ieslēdz atkļūdošanas rīkus, kad tā darbojas localhost, tie ieslēgsies arī lietotnē. Mūsu būves skripti šos karodziņus piespiedu kārtā izslēdz un atsakās būvēt, ja to nevar izdarīt.

Reklāmas

Tīmekļa vietnes reklāmu kods nav tas, ko izmantojam savās lietotnēs. Android mēs izmantojam natīvo AdMob SDK caur Capacitor spraudni, testēšanas laikā ar Google demo reklāmu vienībām un lietotnes savām vienībām tikai produkcijas būvē.

Izkārtojums un saglabāšana

Emulatorā atradām pogas, kas apgrieztas ainavas režīmā, un garus vārdus, kas laužas slikti, ko tīmekļa versija nerādīja. Pārbaudiet katru ekrānu abās orientācijās un pārliecinieties, ka progress paliek pēc lietotnes aizvēršanas un atvēršanas.

Skatiet Ricopop, vēl vienu sagatavi, ko iepakojām Google Play

3. solis: Play Console iestatīšana un veikala ieraksts

Izveidojiet lietotni Play Console, tad izejiet cauri sadaļai App content. Formas, ko aizpildījām katrai spēlei, bija privātuma politika, lietotnes piekļuve, reklāmas, satura vērtējums, mērķauditorija, Data safety, reklāmas ID un valdības, finanšu un veselības deklarācijas.

• Satura vērtējums: Google saka, ka visām lietotnēm jābūt IARC vērtējumam, un lietotnes bez tā tiks noņemtas. To iegūstat, godīgi atbildot uz anketu.
• Data safety: to aizpilda katra lietotne, arī tās, kas nevāc datus. Tajā jāatspoguļo dati, ko vāc trešo pušu SDK, piemēram, reklāmu SDK, un jābūt saitei uz privātuma politiku.
• Mērķauditorija: atbildiet par spēlētājiem, kuriem patiesībā mērķējat. Vērtējums un auditorija ir atsevišķas atbildes.

Veikala ieraksta materiāli

• Lietotnes ikona: 512 × 512 pikseļi, 32 bitu PNG, līdz 1024 KB.
• Funkciju grafika: 1024 × 500 pikseļi, JPEG vai 24 bitu PNG bez alfa.
• Ekrānuzņēmumi: vismaz divi, līdz astoņiem katram ierīces tipam. Spēlēm Google iesaka vismaz trīs 16:9 ainavas (vismaz 1920 × 1080) vai 9:16 portreta (vismaz 1080 × 1920) uzņēmumus, kas rāda īsto spēles procesu.
• Īss apraksts: līdz 80 rakstzīmēm.

4. solis: testēšana, tad produkcija

Mūsu darba plāns sākas ar iekšējo testēšanu: instalējiet lietotni no Play ar reālu kontu un nospēlējiet to pirms visa pārējā. Pēc tam izlaidums tiek paaugstināts līdz produkcijai, kur tas iet cauri Google pārskatīšanai.

Noteikums jauniem personīgajiem kontiem

Google Play Console palīdzība saka, ka personīgajiem izstrādātāju kontiem, kas izveidoti pēc 2023. gada 13. novembra, jāveic slēgts tests ar vismaz 12 testētājiem, kuri ir pastāvīgi pieteikušies vismaz 14 dienas. Pēc tam produkcijas piekļuvi pieprasāt no Dashboard un atbildat uz jautājumiem par slēgto testu, lietotni un tās gatavību produkcijai. Ieplānojiet šīs divas nedēļas savā palaišanas datumā.

Veicot pārskatus klientam, turiet stāvokļus atsevišķi: augšupielādēts testa kanālā, iesniegts pārskatīšanai, apstiprināts un publisks Google Play ir četri dažādi brīži. Mūsu izlaišanas piezīmes fiksē iesniegšanas datumus, nevis apstiprināšanas datumus, un tā dara arī šī rokasgrāmata.

Ko ietver mūsu sagataves un ko varam izdarīt jūsu vietā

Katrā sagatavē ir gatavā mitināmā spēles mape, lasāms pirmkods, rokasgrāmata un 6 mēneši atbalsta vai 12 ar paplašinājumu. Atbalsts aptver sniegto failu uzstādīšanu un lietošanu, kā arī atkārtojamu defektu labošanu. Iepakošana Android, natīvās reklāmas, SDK integrācija un veikala publicēšana ir atsevišķi pakalpojumi.

Ja nevēlaties paši palaist Android Studio, nosūtiet mums sagatavi, veikala konta plānu un termiņu. Mēs atbildam ar apjomu, cenu un laiku, pirms sākam darbu. Pielāgota darba cenrādi nepublicējam.

Pieprasiet piedāvājumu, lai iepakotu spēli Google Play

Biežāk uzdotie jautājumi

Cik maksā HTML5 spēles publicēšana Google Play?

Google ņem vienreizēju 25 USD reģistrācijas maksu izstrādātāja kontam. Citas izmaksas ir spēles licence, veikala grafika un jūsu laiks vai pakalpojuma maksa, ja iepakošanu veic kāds cits.

Vai man vajag 12 testētājus, lai publicētu Google Play?

Tikai tad, ja jūsu konts ir personīgs izstrādātāja konts, kas izveidots pēc 2023. gada 13. novembra. Šiem kontiem pirms produkcijas piekļuves pieprasīšanas jāveic slēgts tests ar vismaz 12 testētājiem, kas pieteikušies vismaz 14 dienas.

APK vai AAB?

AAB. Jaunām lietotnēm Google Play kopš 2021. gada augusta jālieto Android App Bundle. APK joprojām noder, lai instalētu būvi tieši savā testa tālrunī.

Vai lietotne var vienkārši ielādēt manu spēli no manas vietnes?

To mēs nedarām. Spēles failus ietinam lietotnē, lai tā darbotos bezsaistē un nebūtu atkarīga no vietnes. Google surogātpasta politika arī vērš uzmanību uz lietotnēm, kuru galvenais mērķis ir vietnes tīmekļa skats (webview) bez vietnes īpašnieka atļaujas.

Vai jūsu sagataves ir gatavas Google Play uzreiz?

Nē. Tās ir pārlūka spēles, gatavas mitināšanai, un izstrādājumu lapās norādīts, ka natīvo lietotņu būves nav iekļautas. Varat tās iepakot paši pēc iepriekšējiem soļiem vai pasūtīt darbu pēc piedāvājuma.