把你的游戏上架 Google Play

在这里发布的游戏本来就可以安装到手机上（游戏页面的安装按钮）。想让它同时上架 Play 商店，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 商店中的标识，之后永远不能更改；
是否接受 Google 的 Android SDK 许可协议（SDK 只下载一次，约 1 GB，存放在 ~/.jumphp 中）。

它会创建你的上传密钥（~/.jumphp/android/keys/，连同密码：请备份，千万不要放进 git），然后在 games/mon-jeu/dist/android/ 中生成：

文件	用途
`mon-jeu-1.aab`	上传到 Play 商店
`mon-jeu-1.apk`	在你的手机上试用（`adb install`，或者把它复制到手机上）
`assetlinks.json`	证明网站和应用是一对（第 2 步）

它会显示你密钥的 SHA-256 指纹。图标下方的名称是游戏的短名称（game.yaml 中的 pwa: {short_name: …}，没有的话就是它的标题）。

2. 告诉网站这个应用是你的

如果不做这一步，应用打开时会带着地址栏。在工作室中，进入你的游戏页面，找到 Android 应用部分：填写包名和指纹。网站会把它们发布到 https://jumphp.net/.well-known/assetlinks.json，由 Android 进行验证。

你的 Claude 可以用 update_project（android_package、android_fingerprints）来完成。在你自己的服务器上，请把 assetlinks.json 放在 https://你的域名/.well-known/assetlinks.json。

3. 发布到 Google Play

完整细节（密钥、手机上试用、Play Console 的每项声明、审核、后续版本、常见陷阱）：手把手教你上架 Play 商店。简要来说：

在 Play Console 中：创建应用，使用相同的包名。
先做内部测试：上传 .aab，通过测试链接安装。
应用签名（设置）：Google 会用它自己的密钥为应用签名；复制它的 SHA-256 指纹，并把它添加到你自己的指纹旁边（第 2 步），否则地址栏会重新出现。
商店详情（截图：bin/jumphp shot）、内容分级，然后是正式发布。

后续版本

游戏代码会自动更新（因为它就是网站）。要修改应用本身（名称、图标、颜色）：

bin/jumphp twa mon-jeu      # 版本号加 1

games/mon-jeu/android/twa-manifest.json 保存着包名、地址和版本：它应该提交到 git 中。