Windows: WinGet でインストールする
Windows では、Windows パッケージ マネージャーである WinGet を 使用して CLI をインストールします。xbox を PATH に追加します。管理者権限は必要ありません。インストール後にターミナルで
xbox が見つからない場合は、新しいターミナルを開くか、IDE の統合ターミナルを使用している場合は IDE を再起動してください。
CLI を更新するには、次のようにします。
%LOCALAPPDATA%\XboxDevCLI に残ります。WinGet で
インストールした場合は、このページの ZIP の手順ではなく、WinGet のみで更新してください。
次のステップに進みます。
Linux と macOS: スクリプトでインストールする
Linux x64 または macOS では、インストール スクリプトが最新のリリースを~/.local/opt/xboxdevcli にダウンロードし、シェルのスタートアップ ファイルでそのディレクトリを PATH に追加します。
curl と unzip が必要です。
xbox --version でバージョンを確認します。CLI を更新するには、スクリプトをもう一度実行します。削除するには、
~/.local/opt/xboxdevcli と、スクリプトがスタートアップ ファイルに追加した行を削除します。
リリースをダウンロードする
WinGet のない Windows PC など、WinGet とインストール スクリプトが適さない場合は、リリース アーカイブから インストールします。 GitHub Releases ページから、使用しているオペレーティング システムと CPU 用の アーカイブをダウンロードします。
Linux x64 バイナリには glibc 2.27 以降が必要です。macOS バイナリは Microsoft によって署名され、Apple によって
公証されています。.NET をインストールする必要はありません。
プラットフォームごとの手順に示すように、アーカイブ全体を専用の新しいディレクトリに展開し、そのディレクトリを
PATH に
追加します。ディレクトリに既にインストールがある場合は、代わりに
ZIP インストールを更新するの手順に従ってください。
Windows (PowerShell)
-
アーカイブを展開し、展開された実行可能ファイルを確認します。
-
ディレクトリを
PATHに追加します。Windows Search から Edit environment variables for your account を開きます。User variables で Path を編集し、New を選択して、C:\Users\<you>\AppData\Local\Programs\XboxDevCLIなどのディレクトリを入力します。 -
新しいターミナルを開き、バージョンを確認します。
Linux と macOS (Bash または Zsh)
-
アーカイブを展開し、展開された実行可能ファイルを確認します。この例では Linux x64 を使用しています。
macOS では、Apple シリコンの場合は
xbox-osx-arm64.zip、Intel の場合はxbox-osx-x64.zipを使用します。 -
ディレクトリを
PATHに追加します。macOS の既定のシェルである Zsh の場合は~/.zshrcに、 Bash の場合は~/.bashrcに、次の行を追加します。 -
新しいターミナルを開き、バージョンを確認します。
インストールを確認する
xbox --version は、ダウンロードしたリリースのバージョンを、タグの先頭の v を除いて表示します。
古いバージョンが表示される場合は、PATH 上で別の xbox のコピーが先に見つかっています。PowerShell では
Get-Command xbox -All、Bash または Zsh では type -a xbox でそのコピーを見つけ、PATH から
削除してください。
更新を確認する
xbox upgrade は、新しいリリースがあるかどうかと、そのインストール方法を表示します。
Upgrade を参照してください。
winget upgrade Microsoft.Gaming.XBOXDeveloperCLI を実行します。
スクリプトでのインストールを更新するには、インストール スクリプトを
もう一度実行します。ZIP でのインストールを更新するには、次のセクションの手順に従います。
ZIP インストールを更新する
保存された設定とサインイン データはインストールとは別の場所に保存されているため、引き継がれます。 値の保存場所を参照してください。xbox upgradeに表示されるリリース ページ、または GitHub Releases ページから新しいリリースのアーカイブをダウンロードし、 新しいディレクトリに展開します。- 実行中の
xboxプロセスをすべて終了します。 - 古いインストール ディレクトリを同じパスで新しいディレクトリに置き換えるか、
Windows (PowerShell) または
Linux と macOS (Bash または Zsh) の手順のように、
PATHのエントリを新しいディレクトリに変更します。 - 新しいターミナルを開き、
xbox --versionに新しいバージョンが表示されることを確認します。
PATH から外した状態で保持しておいてください。サインインの有効期限が切れている場合は、
もう一度 xbox auth login を実行します。
