ゲームを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上でのIDで、二度と変えられません。 - GoogleのAndroid SDKのライセンスへの同意:SDKは一度だけダウンロードされます(約1 GB、
~/.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フィンガープリントが表示されます。アイコンの下の名前は、ゲームの短い名前です(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 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に入れます。