メインコンテンツまでスキップ

Release 0.5.4

Last updated on October 30, 2026

注釈:本資料はAI技術を用いて翻訳されています。

概要​

AGS CLI 0.5.4 は 0.5.3 に対するパッチリリースです。以下の各項目には、影響する領域を示すタグを付けています。このリリースのすべての項目は [General] に影響します。

ほとんどのスクリプトは変更なしで引き続き動作します。ags auth login --client-id にクライアント名を渡しているスクリプトは、ブラウザの手順の前で停止するようになったため、代わりにクライアント ID を渡してください。ログインプロンプトを読み取るスクリプトは、新しいプロンプトの文言に対応する必要があります。0.5.1 以降からアップグレードするには、ags update --install を実行してください。

ハイライト​

[General] ブラウザが開く前にログインがクライアント ID を確認​

ags auth login は、ブラウザを開く前に、クライアント ID について IAM に問い合わせるようになりました。0.5.4 より前は、クライアント名や入力ミスのある ID がそのままブラウザに渡されていました。その結果、サインインは IAM のエラーページで終了し、CLI は 2 分間待ち続けていました。

Client ID プロンプトで、IAM が認識しない ID を入力すると、CLI は警告とヒントを表示します。その後、プロンプトが再度表示されます:

! IAM has no client with ID "my-cli".
Tip: A client ID looks like 2c7308eb4f3d48e3b892fa0794f14a9c. It is not the client name.

3 回続けて拒否されると、コマンドは No valid client ID after 3 attempts. と表示して停止します。

CLI は、--client-id、AGS_CLIENT_ID、またはプロファイルから取得したクライアント ID も同じ方法で確認します。IAM がその ID を認識しない場合、コマンドは ID の取得元を示すエラーで停止します。たとえば IAM has no client with ID "my-cli" (from --client-id). と表示されます。

CLI は、IAM からクライアントのリダイレクト URI も読み取ります。その URI が、たとえば別のポートを使用しているなどの理由で、このログインに戻れない場合、CLI はブラウザを待つ前に警告とヒントを表示します。

確認のために CLI が IAM に接続できない場合は、警告が表示され、ログインは従来どおり続行されます。

[General] 新しいマシンでの最初のコマンドが失敗しなくなりました​

新しいマシンでは、最初の ags コマンドが No active profile で失敗したり、コマンド自身の出力の前に Waiting for file lock on profile config for 'default'… が表示されたりすることがありました。このエラーでは、必要のない ags profile create も提案されていました。同じコマンドをもう一度実行すると、正常に動作していました。

原因は CLI のテレメトリでした。テレメトリが、コマンドと同時にデフォルトプロファイルを設定していたためです。現在は、テレメトリは設定を読み取るだけで、プロファイルはコマンドが作成します。

改善​

  • [General] Base URL プロンプトに例が表示されるようになりました: Enter Base URL (e.g. https://<studio-id>-<title-id>.prod.gamingservices.accelbyte.io):。Base URL のホストは、ゲームの Namespace ID です。これは、スタジオ ID とゲームのタイトル ID をハイフンでつなげたものです。Install and sign in を参照してください。
  • [General] Client ID プロンプトに ID の例が表示され、空の回答で新しいクライアントを作成できることが示されるようになりました: Enter Client ID (e.g. 2c7308eb4f3d48e3b892fa0794f14a9c, or leave empty to create a new one):。
  • [General] ログインプロンプトから新しい IAM クライアントを作成した後、CLI は専用のプロンプトでその ID を尋ねます: Paste the new client's Client ID:。
  • [General] ブラウザを開く前に、CLI はサインインに使用するクライアントを表示します: Signing in with IAM client <id>。
  • [General] Base URL が gamingservices.xsolla.com にある場合、テレメトリは AccelByte のプロジェクトとは別のプロジェクトに送信されます。これは、Base URL が AGS_BASE_URL から取得される場合も、プロファイルから取得される場合も同じです。その他のアドレスのテレメトリは変更されません。

バグ修正​

  • [General] 進行状況の行が端末の幅に収まるようになりました。行より狭い端末では、再描画のたびにその行のコピーが画面に残っていました。ログインの待機行も短くなりました: Waiting for browser sign-in on 127.0.0.1:8080... 120s left (Ctrl-C to cancel)。
  • [General] 公開されたセキュリティアドバイザリに対応するため、5 つのライブラリを更新しました: rustls、rustls-webpki、webpki-roots、tokio、zip。証明書の検証では、信頼されなくなった emSign の中間証明書を経由するチェーンを拒否するようになりました。

完全なリリースノート​

変更点の完全なリストについては、GitHub の 0.5.4 リリース を参照してください。