Публикуване на HTML5 игра в Google Play с Capacitor, стъпка по стъпка

За да публикувате HTML5 игра в Google Play, опаковате папката с играта в нативен Android проект с Capacitor, компилирате подписан Android App Bundle в Android Studio, създавате приложението в Play Console, попълвате формулярите за съдържание и качвате пакета в тестов канал, преди продукция. Ако акаунтът ви за разработчик е личен и е създаден след 13 ноември 2023 г., Google изисква и затворен тест с поне 12 тестери за 14 дни, преди да можете да кандидатствате за продукция.

Направихме това със собствените си игри. През октомври 2026 г. опаковахме Ricopop и Velvet Pool с Capacitor и изпратихме и двете за преглед за продукция в Google Play, а също и нашата екшън игра Little Ninja Dash. Това ръководство съчетава каквото казват официалните страници на Capacitor, Android и Play Console, прочетени на 30 октомври 2026 г., с това, което записват нашите собствени бележки за издаване. Правилата и изискванията се променят, затова проверявайте всяка свързана страница, преди да подадете.

Преди да публикувате HTML5 игра в Google Play

• Акаунт за разработчик в Google Play. Google таксува еднократна регистрационна такса от 25 USD и изисква всеки разработчик да потвърди самоличността си. Личните акаунти трябва също да потвърдят достъп до Android устройство с мобилното приложение Play Console, преди публикуване.
• Node.js и Android Studio. Документацията на Capacitor за Android казва, че Android приложенията на Capacitor се конфигурират и управляват чрез Android Studio.
• Игра, която работи офлайн от собствената си папка, с index.html в корена.
• Лиценз за играта. При нашите шаблони един лиценз покрива един краен продукт и можете да публикувате тази игра където пожелаете, включително в Google Play и App Store. Не можете да препродавате самия шаблон. Питайте ни, преди да добавите цена или покупки в приложението, защото нашите условия говорят за достъп на играчите безплатно или чрез реклами.

Нашите издания на шаблони са браузърни игри. Всяка страница на издание посочва, че нативни build-ове за приложения не са включени, така че стъпките по-долу са работа, която вършите вие, или работа, която поръчвате от нас по оферта.

Вижте Velvet Pool, билярд шаблонът, който опаковахме и за Android

Стъпка 1: опаковайте папката с играта с Capacitor

Capacitor изисква package.json, папка с компилираните уеб файлове и index.html в корена на тази папка. Страницата му за начало предупреждава, че index.html трябва да има таг head, иначе плъгините няма да работят. Изтеглен HTML5 шаблон обикновено вече има папката: при нас тя е game/.

1. В нова папка на проекта пуснете npm i @capacitor/core и npm i -D @capacitor/cli.
2. Пуснете npx cap init. Той пита за името на приложението, app ID (обратен домейн, например com.yourstudio.yourgame) и уеб папката. Насочете webDir към папката на играта си.
3. Пуснете npm i @capacitor/android, после npx cap add android. Това създава проекта android/.
4. Пускайте npx cap sync всеки път, когато промените файловете на играта. Той ги копира в нативния проект.
5. Пуснете npx cap open android, за да отворите проекта в Android Studio.

Документацията на Capacitor казва, че се поддържа API 24 и по-нов, тоест Android 7 и нагоре. Нашите Android проекти използват този минимум.

Какво правим по различен начин: държим нативния проект в отделно работно пространство mobile/, което копира играта в собствена уеб папка. Уебсайт версията остава непокътната, а всичко, което принадлежи само на приложението, например нативните реклами, е в работното пространство.

Стъпка 2: компилирайте и подпишете пакета за приложението

От август 2021 г. новите приложения в Google Play трябва да се публикуват като Android App Bundles (AAB), а не като APK. В Android Studio използвайте менюто Build, опцията Generate Signed Bundle/APK, изберете Android App Bundle и създайте или изберете keystore.

Този keystore пази вашия ключ за качване. Страницата на Google за подписване на приложения обяснява, че при Play App Signing, който новите приложения трябва да настроят при първата публикация, Google пази ключа за подписване на приложението, а вие подписвате всяко качване с ключа за качване. Пазете ключа за качване в тайна, изберете силни пароли и съхранявайте keystore на сигурно място. Ако се загуби или бъде компрометиран, Play Console ви позволява да поискате нулиране на ключа за качване.

• Целево ниво на API: от 31 август 2026 г. новите приложения и актуализации трябва да са насочени към Android 16 (API level 36) или по-високо. Проверете целта в android/app/build.gradle.
• Код на версията: увеличавайте го преди всяко качване. Всеки пакет, който качвате, изчерпва кода на версията си, затова преди всеки build четем най-високия в Play Console.
• Само release build: без debug менюта, тестови рекламни ID-та или шорткъти за разработчици в пакета, който изпращате към продукция.

Какво се счупва във webview и какво направихме по въпроса

Игра, която работи добре в браузър, може да се държи различно в приложение. Това са проблемите, записани в нашите бележки за издаване, с документираната поправка, когато има такава.

Бутонът Назад на Android

Плъгинът App на Capacitor има събитие backButton. Документацията му казва, че слушането на това събитие изключва стандартното поведение на бутона Назад, така че вие решавате какво прави Назад, и предлага App.exitApp(), за да затвори приложението. В Velvet Pool накарахме Назад да отваря менюто за пауза вместо да затваря играта.

Пауза и продължаване

Същият плъгин изпраща събития appStateChange, pause и resume. Използвайте ги, за да паузирате играта, таймерите и всяка работеща реклама, когато играчът напусне приложението, и да продължите чисто.

Debug шорткъти на localhost

В приложението Capacitor сервира играта от локален адрес. Ако играта ви включва debug инструменти, когато работи на localhost, те ще се включат и в приложението. Нашите build скриптове принудително изключват тези флагове и отказват да компилират, ако не могат.

Реклами

Кодът за реклами на уебсайта не е този, който използваме в нашите приложения. На Android използваме нативния SDK на AdMob чрез плъгин за Capacitor, с демо рекламни блокове на Google по време на тестване и собствените блокове на приложението само в production build.

Оформление и запазване

На емулатора открихме бутони, отрязани в хоризонтална ориентация, и дълги думи, които се чупят зле, което версията за браузър не показваше. Тествайте всеки екран в двете ориентации и проверете дали напредъкът оцелява при затваряне и отваряне на приложението.

Вижте Ricopop, друг шаблон, който опаковахме за Google Play

Стъпка 3: настройка на Play Console и страница в магазина

Създайте приложението в Play Console, после минете през секцията за съдържание на приложението. Формулярите, които попълнихме за всяка игра, бяха: политика за поверителност, достъп до приложението, реклами, възрастова оценка, целева аудитория, Data safety, рекламният ID и декларациите за държавни, финансови и здравни данни.

• Възрастова оценка: Google казва, че всички приложения трябва да имат рейтинг IARC, а приложенията без такъв ще бъдат премахнати. Получавате го, като отговорите честно на въпросника.
• Data safety: всяко приложение трябва да го попълни, включително приложенията, които не събират данни. Той трябва да отразява данните, събирани от SDK на трети страни, като рекламен SDK, и изисква връзка към политика за поверителност.
• Целева аудитория: отговаряйте за играчите, към които наистина се насочвате. Рейтингът и аудиторията са отделни отговори.

Активи за страницата в магазина

• Икона на приложението: 512 на 512 пиксела, 32-битов PNG, до 1024 KB.
• Feature graphic (промоционална графика): 1024 на 500 пиксела, JPEG или 24-битов PNG без алфа канал.
• Снимки от екрана: поне две, до осем за тип устройство. За игри Google препоръчва поне три хоризонтални 16:9 (поне 1920 на 1080) или вертикални 9:16 (поне 1080 на 1920) снимки, които показват реална игра.
• Кратко описание: до 80 символа.

Стъпка 4: тестване, после продукция

Нашият ръководен план слага първо вътрешното тестване: инсталирайте приложението от Play с реален акаунт и го изиграйте преди всичко друго. После версията се повишава до продукция, където минава през прегледа на Google.

Правилото за нови лични акаунти

Центърът за помощ на Play Console казва, че личните акаунти за разработчици, създадени след 13 ноември 2023 г., трябва да проведат затворен тест с минимум 12 тестери, които са се записали непрекъснато за поне 14 дни. След това кандидатствате за достъп до продукция от таблото (Dashboard) и отговаряте на въпроси за затворения тест, приложението и готовността му за продукция. Включете тези две седмици в датата на стартиране.

Когато докладвате на клиент, пазете състоянията отделно: качено в тестов канал, подадено за преглед, одобрено и публично в Google Play са четири различни момента. Нашите бележки за издаване записват датите на подаване, а не на одобрение, и това ръководство също.

Какво включват нашите шаблони и каква част можем да свършим вместо вас

Всеки шаблон идва с готовата за хостинг папка на играта, четим сорс код, ръководство и 6 месеца поддръжка, или 12 с разширението. Поддръжката покрива инсталирането и използването на доставените файлове и отстраняването на възпроизводими дефекти. Опаковането за Android, нативните реклами, интеграцията на SDK и публикуването в магазина са отделни услуги.

Ако предпочитате да не работите сами в Android Studio, изпратете ни шаблона, плана на акаунта в магазина и крайния срок. Отговаряме с обхват, цена и срокове, преди да започне работа. Не публикуваме ценоразпис за работа по поръчка.

Поискайте оферта за опаковане на играта ви за Google Play

Често задавани въпроси

Колко струва публикуването на HTML5 игра в Google Play?

Google таксува еднократна регистрационна такса от 25 USD за акаунт за разработчик. Другите ви разходи са лицензът за играта, арта за магазина и вашето време, или услуга по оферта, ако някой друг прави опаковането.

Трябват ли ми 12 тестери, за да публикувам в Google Play?

Само ако акаунтът ви е личен акаунт за разработчик, създаден след 13 ноември 2023 г. Тези акаунти трябва да проведат затворен тест с поне 12 тестери, записани за поне 14 дни, преди да кандидатстват за достъп до продукция.

APK или AAB?

AAB. Новите приложения в Google Play трябва да използват Android App Bundle от август 2021 г. APK все още е полезен, за да инсталирате директно build на собствения си тестов телефон.

Може ли приложението просто да зарежда играта от уебсайта ми?

Това не го правим. Вграждаме файловете на играта в приложението, за да работи офлайн и да не зависи от сайт. Политиката на Google срещу спама се отнася и за приложения, чиято основна цел е webview на уебсайт без разрешение на собственика.

Готови ли са вашите шаблони за Google Play от кутията?

Не. Те са браузърни игри, готови за хостинг, а страниците на продуктите казват, че нативни build-ове за приложения не са включени. Можете да ги опаковате сами със стъпките по-горе или да поръчате работата от нас по оферта.