Ваша игра в 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 (SDK скачивается один раз, ~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. Сообщить сайту, что приложение ваше
Без этого приложение откроется с адресной строкой. В Студии, на странице вашей игры, в разделе Приложение для 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.