JA

ゲームを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に公開する:ステップバイステップ。要点は次のとおりです。

  1. Play Consoleで、同じパッケージ名のアプリを作成します。
  2. まず内部テスト:.aabをアップロードし、テスト用のリンクからインストールします。
  3. アプリの署名(設定):Googleは自分のキーでアプリに署名します。そのSHA-256フィンガープリントをコピーして、自分のキーの隣に追加してください(手順2)。そうしないと、アドレスバーが戻ってきます。
  4. ストアの掲載情報(スクリーンショット:bin/jumphp shot)、コンテンツのレーティング、そして本番公開。

次のバージョン

ゲームのコードは自動的に更新されます(サイトがそのものだからです)。アプリ自体(名前、アイコン、色)を変える場合:

bin/jumphp twa mon-jeu      # バージョン番号が1つ上がります

games/mon-jeu/android/twa-manifest.jsonには、パッケージ、アドレス、バージョンが保存されます。これはgitに入れます。