HTML5 žaidimo paskelbimas Google Play su Capacitor

Norėdami paskelbti HTML5 žaidimą Google Play, žaidimo aplanką įpakuojate į natyvų Android projektą su Capacitor, Android Studio sukuriate pasirašytą Android programos paketą (App Bundle), Play Console sukuriate programėlę, atsakote į jos turinio formas ir įkeliate paketą į bandomąjį kanalą prieš gamybą. Jei jūsų kūrėjo paskyra yra asmeninė, sukurta po 2023 m. lapkričio 13 d., Google taip pat reikalauja uždaro testavimo su bent 12 testuotojų 14 dienų, prieš galint kreiptis dėl gamybos.

Tai darėme su savo žaidimais. 2026 m. spalio mėn. supakavome Ricopop ir Velvet Pool su Capacitor ir abu išsiuntėme į Google Play gamybos peržiūrą, taip pat ir mūsų veiksmo žaidimą Little Ninja Dash. Šis vadovas sujungia tai, ką oficialūs Capacitor, Android ir Play Console puslapiai sako (skaityta 2026 m. spalio 30 d.), su tuo, ką fiksuoja mūsų pačių leidimų užrašai. Taisyklės ir reikalavimai keičiasi, todėl prieš pateikdami patikrinkite kiekvieną nuorodą.

Prieš paskelbiant HTML5 žaidimą Google Play

• Google Play kūrėjo paskyra. Google taiko vienkartinį registracijos mokestį 25 USD ir reikalauja, kad kiekvienas kūrėjas patvirtintų tapatybę. Asmeninės paskyros prieš skelbiant taip pat turi patvirtinti prieigą prie Android įrenginio su Play Console mobiliąja programėle.
• Node.js ir Android Studio. Capacitor Android dokumentacija sako, kad Capacitor Android programėlės konfigūruojamos ir valdomos per Android Studio.
• Žaidimas, kuris veikia neprisijungus iš savo aplanko, su index.html šakniniame aplanke.
• Žaidimo licencija. Su mūsų šablonais viena licencija galioja vienam galutiniam produktui, ir galite publikuoti tą žaidimą kur norite, įskaitant Google Play ir App Store. Šablono pačio perparduoti negalite. Prieš pridėdami kainą ar pirkimus programėlėje klauskite mūsų, nes mūsų sąlygos kalba apie žaidėjų prieigą nemokamai arba per skelbimus.

Mūsų šablonų leidimai yra naršyklės žaidimai. Kiekvieno leidimo puslapis nurodo, kad natyvūs programėlių surinkimai neįtraukti, todėl žemiau aprašyti žingsniai yra jūsų darbas arba darbas, kurį užsakote iš mūsų pagal pasiūlymą.

Žiūrėkite Velvet Pool, biliardo šabloną, kurį taip pat supakavome Android

1 žingsnis: apvyniokite žaidimo aplanką su Capacitor

Capacitor reikia package.json, aplanko su surinktais žiniatinklio failais ir index.html to aplanko šaknyje. Jo pradžios puslapis įspėja, kad index.html turi turėti head žymę, kitaip papildiniai neveiks. Parsisiųsto HTML5 šablono aplankas paprastai jau yra: mūsų jis yra game/.

1. Naujame projekto aplanke paleiskite npm i @capacitor/core ir npm i -D @capacitor/cli.
2. Paleiskite npx cap init. Jis paklaus programėlės pavadinimo, programėlės ID (atvirkštinis domenas, pavyzdžiui com.yourstudio.yourgame) ir žiniatinklio aplanko. Nurodykite webDir į savo žaidimo aplanką.
3. Paleiskite npm i @capacitor/android, tada npx cap add android. Tai sukuria android/ projektą.
4. Po kiekvieno žaidimo failų pakeitimo paleiskite npx cap sync. Jis nukopijuoja failus į natyvų projektą.
5. Paleiskite npx cap open android, kad atidarytumėte projektą Android Studio.

Capacitor dokumentacija sako, kad palaikoma API 24 ir naujesnė, Android 7 ir naujesnė. Mūsų Android projektai naudoja šį minimumą.

Mes darome kitaip: natyvų projektą laikome atskirame mobile/ darbo aplanke, kuris nukopijuoja žaidimą į savo žiniatinklio aplanką. Svetainės versija lieka nepaliesta, o viskas, kas priklauso tik programėlei, pavyzdžiui natyvios reklamos, yra darbo aplanke.

2 žingsnis: surinkite ir pasirašykite programos paketą

Nuo 2021 m. rugpjūčio nauji Google Play programėlės turi būti publikuojamos kaip Android programos paketai (AAB), o ne APK. Android Studio pasirinkite Build, tada Generate Signed Bundle/APK, pasirinkite Android App Bundle ir sukurkite arba pasirinkite keystore.

Tas keystore saugo jūsų įkėlimo raktą. Google programų pasirašymo puslapis paaiškina, kad naudojant Play App Signing (kurį nauji programėlės privalo nustatyti pirmą kartą publikuojant), Google saugo programos pasirašymo raktą, o jūs pasirašote kiekvieną įkėlimą įkėlimo raktu. Įkėlimo raktą laikykite paslaptyje, pasirinkite stiprius slaptažodžius ir keystore laikykite saugioje vietoje. Jei jį pamestumėte ar jis būtų pažeistas, Play Console leidžia prašyti įkėlimo rakto atstatymo.

• Tikslinis API lygis: nuo 2026 m. rugpjūčio 31 d. nauji programėlės ir atnaujinimai turi tikslinti Android 16 (API level 36) ar aukštesnį. Tikslą tikrinkite android/app/build.gradle faile.
• Versijos kodas: pakelkite jį prieš kiekvieną įkėlimą. Kiekvienas įkeltas paketas išnaudoja savo versijos kodą, todėl prieš kiekvieną surinkimą perskaitome aukščiausią Play Console.
• Tik išleidimo surinkinys: jokių derinimo meniu, bandomųjų skelbimų ID ar kūrėjo trumpinių paketuose, kuriuos siunčiate gamybai.

Ką webview sugenda ir ką mes su tuo padarėme

Žaidimas, kuris gerai veikia naršyklėje, programėlėje gali elgtis kitaip. Tai problemos, kurias fiksavo mūsų leidimų užrašai, su dokumentuotu sprendimu, kai jis yra.

Android atgal mygtukas

Capacitor App papildinys turi backButton įvykį. Jo dokumentacija sako, kad jo klausymas išjungia numatytąjį atgal mygtuko elgesį, todėl jūs nusprendžiate, ką atgal atlieka, ir yra App.exitApp(), kad uždarytumėte programėlę. Velvet Pool atgal mygtukas atidaro pauzės meniu, o ne uždaro žaidimą.

Pauzė ir tęsimas

Tas pats papildinys siunčia appStateChange, pause ir resume įvykius. Juos naudokite pauzei: sustabdykite žaidimą, laikmačius ir bet kurią veikiančią reklamą, kai žaidėjas palieka programėlę, ir tęskite švariai.

Derinimo trumpiniai localhost

Programėlėje Capacitor žaidimą teikia iš vietinio adreso. Jei jūsų žaidimas įjungia derinimo įrankius, kai veikia localhost, jie įsijungs ir programėlėje. Mūsų surinkimo scenarijai tas žymes priverčia išjungtas ir atsisako surinkti, jei to padaryti negali.

Reklama

Svetainės reklamos kodas nėra tai, ką naudojame programėlėse. Android naudojame natyvų AdMob SDK per Capacitor papildinį, testavimo metu su Google demonstraciniais skelbimų vienetais, o tik gamybiniame surinkime — su programėlės pačios vienetais.

Išdėstymas ir išsaugojimas

Emuliatoriuje matėme nukirptus mygtukus horizontaliai ir ilgus žodžius, kurie blogai lūžta, ko naršyklės versija nerodė. Išbandykite kiekvieną ekraną abiejose orientacijose ir patikrinkite, ar pažanga išlieka uždarius ir vėl atidarius programėlę.

Žiūrėkite Ricopop, kitą šabloną, kurį supakavome Google Play

3 žingsnis: Play Console nustatymas ir parduotuvės sąrašas

Sukurkite programėlę Play Console, tada praeikite programėlės turinio skyrių. Formos, kurias pildėme kiekvienam žaidimui, buvo: privatumo politika, programėlės prieiga, skelbimai, turinio reitingas, tikslinė auditorija, Data safety (duomenų sauga), reklamos ID ir vyriausybės, finansų bei sveikatos deklaracijos.

• Turinio reitingas: Google sako, kad visos programėlės turi turėti IARC reitingą, o be jo programėlės bus pašalintos. Jį gausite sąžiningai atsakydami į klausimyną.
• Data safety: kiekviena programėlė turi ją užpildyti, įskaitant programėles, kurios nerenka duomenų. Ji turi atspindėti trečiųjų šalių SDK, pavyzdžiui skelbimų SDK, renkamus duomenis, ir reikia privatumo politikos nuorodos.
• Tikslinė auditorija: atsakykite apie žaidėjus, kuriems iš tikrųjų skiriate. Reitingas ir auditorija yra atskiri atsakymai.

Parduotuvės sąrašo medžiaga

• Programėlės piktograma: 512 × 512 pikselių, 32 bitų PNG, iki 1024 KB.
• Pagrindinė grafika: 1024 × 500 pikselių, JPEG arba 24 bitų PNG be alfa kanalo.
• Ekrano nuotraukos: bent dvi, iki aštuonių kiekvienam įrenginio tipui. Žaidimams Google rekomenduoja bent tris 16:9 horizontalias (bent 1920 × 1080) ar 9:16 vertikalias (bent 1080 × 1920) nuotraukas, rodančias tikrą žaidimo eigą.
• Trumpas aprašymas: iki 80 simbolių.

4 žingsnis: testavimas, tada gamyba

Mūsų vykdymo vadove pirmiausia skiriamas vidinis testavimas: įdiekite programėlę iš Play su tikra paskyra ir pažaiskite ją prieš bet ką kitą. Tada išleidimas perkeliamas į gamybą, kur eina per Google peržiūrą.

Taisyklė naujoms asmeninėms paskyroms

Google Play Console pagalba sako, kad asmeninės kūrėjo paskyros, sukurtos po 2023 m. lapkričio 13 d., turi vykdyti uždarą testą su bent 12 testuotojų, kurie nuolat prisijungę bent 14 dienų. Po to kreipiatės dėl gamybos prieigos iš Dashboard ir atsakote į klausimus apie uždarą testą, programėlę ir jos paruošimą gamybai. Įskaičiuokite šias dvi savaites į paleidimo datą.

Kai pranešate klientui, atskirkite būsenas: įkelta į bandomąjį kanalą, pateikta peržiūrai, patvirtinta ir viešai Google Play yra keturi skirtingi momentai. Mūsų išleidimo užrašai fiksuoja pateikimo datas, o ne patvirtinimo datas, ir šis vadovas taip pat.

Ką apima mūsų šablonai ir ką galime padaryti jums

Kiekvienas šablonas ateina su paruoštu talpinimui žaidimo aplanku, įskaitomu šaltiniu, vadovu ir 6 mėnesių palaikymu, arba 12 su priedu. Palaikymas apima pateiktų failų diegimą ir naudojimą bei atkuriamų defektų taisymą. Pakavimas Android, natyvios reklamos, SDK integracija ir publikavimas parduotuvėje yra atskiros paslaugos.

Jei nenorite patys naudoti Android Studio, atsiųskite mums šabloną, parduotuvės paskyros planą ir terminą. Atsakome su apimtimi, kaina ir laiku prieš bet kokį darbą. Individualaus darbo kainų sąrašo neskelbiame.

Prašykite pasiūlymo supakuoti savo žaidimą Google Play

Dažnai užduodami klausimai

Kiek kainuoja paskelbti HTML5 žaidimą Google Play?

Google taiko vienkartinį 25 USD registracijos mokestį kūrėjo paskyrai. Kiti kaštai yra žaidimo licencija, parduotuvės meno darbai ir jūsų laikas arba paslauga pagal pasiūlymą, jei pakavimą atlieka kas nors kitas.

Ar man reikia 12 testuotojų, kad paskelbčiau Google Play?

Tik jei jūsų paskyra yra asmeninė kūrėjo paskyra, sukurta po 2023 m. lapkričio 13 d. Tokios paskyros turi vykdyti uždarą testą su bent 12 testuotojų, prisijungusių bent 14 dienų, prieš kreipiantis dėl gamybos prieigos.

APK ar AAB?

AAB. Nauji Google Play programėlės turi naudoti Android App Bundle nuo 2021 m. rugpjūčio. APK vis dar naudingas tiesiogiai įdiegiant surinkinį į savo bandomąjį telefoną.

Ar programėlė gali tiesiog įkelti mano žaidimą iš mano svetainės?

To nedarome. Žaidimo failus supakuojame programėlės viduje, todėl ji veikia neprisijungus ir nepriklauso nuo svetainės. Google šlamšto politika taip pat nukreipta prieš programėles, kurių pagrindinis tikslas yra svetainės webview be savininko leidimo.

Ar jūsų šablonai paruošti Google Play iš karto?

Ne. Tai žaidimai naršyklėms, paruošti talpinimui, o prekių puslapiuose nurodyta, kad natyvių programėlių surinkimai neįtraukti. Galite juos supakuoti patys pagal aukščiau pateiktus žingsnius arba užsakyti darbą iš mūsų pagal pasiūlymą.