Ваша гра в Google Play
Гру, опубліковану тут, уже можна встановити на телефон (кнопка Встановити на її сторінці). Щоб вона була також у Play Store, JumPHP робить із неї справжній застосунок Android: Trusted Web Activity. Це сторінка гри в Chrome на весь екран, без адресного рядка, з її іконкою та назвою; гра залишається тією, що на сайті (оновлення, опубліковане тут, одразу потрапляє в застосунок). Для застосунку, що працює без мережі та без браузера: нативний застосунок Android.
Потрібно: проєкт JumPHP на вашому комп'ютері (на вашому комп'ютері), Docker і акаунт розробника Google Play (25 $ одноразово). Ваш Claude може зробити все замість вас: попросіть його «розмісти мою гру в Google Play».
1. Зібрати застосунок
bin/jumphp twa mon-jeu --url https://jumphp.net/mon-jeu
Під час першого запуску команда запитує:
- назву пакета застосунку (наприклад,
io.github.moi.mon_jeu): його ідентифікатор у Play Store, він більше ніколи не змінюється; - чи приймаєте ліцензію Android SDK від Google (його завантажують один раз, ~1 ГБ, у
~/.jumphp).
Вона створює ваш ключ завантаження (~/.jumphp/android/keys/, з його паролем: збережіть їх, ніколи
не кладіть у git), а потім збирає в games/mon-jeu/dist/android/:
| Файл | Для чого |
|---|---|
mon-jeu-1.aab |
Play Store |
mon-jeu-1.apk |
спробувати на вашому телефоні (adb install або скопіюйте на нього) |
assetlinks.json |
довести, що сайт і застосунок належать одне одному (крок 2) |
Вона показує відбиток SHA-256 вашого ключа. Назва під іконкою — це коротка назва гри
(pwa: {short_name: …} у game.yaml, інакше її заголовок).
2. Повідомити сайту, що застосунок ваш
Без цього застосунок відкривається з адресним рядком. У Studio, на сторінці вашої гри, у розділі
Застосунок Android: назва пакета та відбиток. Сайт публікує їх у
https://jumphp.net/.well-known/assetlinks.json, який перевіряє Android.
Ваш Claude робить це через update_project (android_package, android_fingerprints). На вашому власному
сервері розмістіть assetlinks.json за адресою https://votre-domaine/.well-known/assetlinks.json.
3. Опублікувати його в Google Play
Усі подробиці (ключі, перевірки на телефоні, кожна декларація Play Console, перевірка, наступні версії, підводні камені): Публікація в Play Store крок за кроком. Коротко:
- У Play Console: Створити застосунок з тією самою назвою пакета.
- Спершу внутрішнє тестування: надішліть
.aab, встановіть його за тестовим посиланням. - Підписування застосунку (Налаштування): Google підписує застосунок власним ключем; скопіюйте його відбиток SHA-256 і додайте його поруч зі своїм (крок 2), інакше адресний рядок повернеться.
- Сторінка застосунку (скриншоти:
bin/jumphp shot), класифікація вмісту, потім продакшн.
Наступні версії
Код гри оновлюється сам (це сайт). Щоб змінити сам застосунок (назву, іконку, кольори):
bin/jumphp twa mon-jeu # номер версії збільшується на 1
games/mon-jeu/android/twa-manifest.json зберігає пакет, адресу та версію: він іде в git.