> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# インストール

> Windows、Linux、macOS 用の CLI をダウンロードしてインストールします。

XBOX CLI は、Windows では WinGet を使用して、Linux または macOS ではインストール スクリプトを使用して、または任意のプラットフォームで
リリース アーカイブからインストールできます。代わりにソースからビルドする場合は、
[Building from source](https://github.com/xbox/cli/blob/v0.4.2/docs/contributing/building-from-source.md) を参照してください。

## Windows: WinGet でインストールする

Windows では、Windows パッケージ マネージャーである [WinGet](https://learn.microsoft.com/windows/package-manager/winget/) を
使用して CLI をインストールします。

```powershell theme={null}
winget install xbox
xbox --version
```

WinGet は `xbox` を `PATH` に追加します。管理者権限は必要ありません。インストール後にターミナルで
`xbox` が見つからない場合は、新しいターミナルを開くか、IDE の統合ターミナルを使用している場合は IDE を再起動してください。

CLI を更新するには、次のようにします。

```powershell theme={null}
winget upgrade Microsoft.Gaming.XBOXDeveloperCLI
```

削除するには、次のようにします。

```powershell theme={null}
winget uninstall Microsoft.Gaming.XBOXDeveloperCLI
```

アンインストールしても、保存された設定とサインイン データは `%LOCALAPPDATA%\XboxDevCLI` に残ります。WinGet で
インストールした場合は、このページの ZIP の手順ではなく、WinGet のみで更新してください。
[次のステップ](#next-steps)に進みます。

## Linux と macOS: スクリプトでインストールする

Linux x64 または macOS では、インストール スクリプトが最新のリリースを
`~/.local/opt/xboxdevcli` にダウンロードし、シェルのスタートアップ ファイルでそのディレクトリを `PATH` に追加します。
`curl` と `unzip` が必要です。

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/xbox/cli/main/install.sh | sh
```

スクリプトは、変更したスタートアップ ファイルを出力します。新しいターミナルを開き、
`xbox --version` でバージョンを確認します。CLI を更新するには、スクリプトをもう一度実行します。削除するには、
`~/.local/opt/xboxdevcli` と、スクリプトがスタートアップ ファイルに追加した行を削除します。

## リリースをダウンロードする

WinGet のない Windows PC など、WinGet とインストール スクリプトが適さない場合は、リリース アーカイブから
インストールします。

[GitHub Releases ページ](https://github.com/xbox/cli/releases/latest)から、使用しているオペレーティング システムと CPU 用の
アーカイブをダウンロードします。

| プラットフォーム | アセット | バイナリ |
| - | - | - |
| Windows x64 | `xbox-win-x64.zip` | `xbox.exe` |
| Linux x64 | `xbox-linux-x64.zip` | `xbox` |
| Apple シリコン搭載の macOS | `xbox-osx-arm64.zip` | `xbox` |
| Intel 搭載の macOS | `xbox-osx-x64.zip` | `xbox` |

Linux x64 バイナリには glibc 2.27 以降が必要です。macOS バイナリは Microsoft によって署名され、Apple によって
公証されています。.NET をインストールする必要はありません。

プラットフォームごとの手順に示すように、アーカイブ全体を専用の新しいディレクトリに展開し、そのディレクトリを `PATH` に
追加します。ディレクトリに既にインストールがある場合は、代わりに
[ZIP インストールを更新する](#update-a-zip-installation)の手順に従ってください。

## Windows (PowerShell)

1. アーカイブを展開し、展開された実行可能ファイルを確認します。

   ```powershell theme={null}
   $cliDir = Join-Path $env:LOCALAPPDATA 'Programs\XboxDevCLI'
   Expand-Archive -LiteralPath "$HOME\Downloads\xbox-win-x64.zip" -DestinationPath $cliDir
   & "$cliDir\xbox.exe" --version
   ```

2. ディレクトリを `PATH` に追加します。Windows Search から **Edit environment variables for
   your account** を開きます。**User variables** で **Path** を編集し、**New** を選択して、
   `C:\Users\<you>\AppData\Local\Programs\XboxDevCLI` などのディレクトリを入力します。

3. 新しいターミナルを開き、バージョンを確認します。

   ```powershell theme={null}
   xbox --version
   ```

## Linux と macOS (Bash または Zsh)

1. アーカイブを展開し、展開された実行可能ファイルを確認します。この例では Linux x64 を使用しています。
   macOS では、Apple シリコンの場合は `xbox-osx-arm64.zip`、Intel の場合は `xbox-osx-x64.zip` を使用します。

   ```bash theme={null}
   cli_dir="$HOME/.local/opt/xboxdevcli"
   mkdir -p "$cli_dir"
   unzip "$HOME/Downloads/xbox-linux-x64.zip" -d "$cli_dir"
   chmod u+x "$cli_dir/xbox"
   "$cli_dir/xbox" --version
   ```

2. ディレクトリを `PATH` に追加します。macOS の既定のシェルである Zsh の場合は `~/.zshrc` に、
   Bash の場合は `~/.bashrc` に、次の行を追加します。

   ```bash theme={null}
   export PATH="$HOME/.local/opt/xboxdevcli:$PATH"
   ```

3. 新しいターミナルを開き、バージョンを確認します。

   ```bash theme={null}
   xbox --version
   ```

## インストールを確認する

`xbox --version` は、ダウンロードしたリリースのバージョンを、タグの先頭の `v` を除いて表示します。
古いバージョンが表示される場合は、`PATH` 上で別の `xbox` のコピーが先に見つかっています。PowerShell では
`Get-Command xbox -All`、Bash または Zsh では `type -a xbox` でそのコピーを見つけ、`PATH` から
削除してください。

## 更新を確認する

`xbox upgrade` は、新しいリリースがあるかどうかと、そのインストール方法を表示します。
[Upgrade](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/upgrade.md) を参照してください。

```bash theme={null}
xbox upgrade
```

WinGet でのインストールを更新するには、`winget upgrade Microsoft.Gaming.XBOXDeveloperCLI` を実行します。
スクリプトでのインストールを更新するには、[インストール スクリプト](#linux-and-macos-install-with-a-script)を
もう一度実行します。ZIP でのインストールを更新するには、次のセクションの手順に従います。

## ZIP インストールを更新する

保存された設定とサインイン データはインストールとは別の場所に保存されているため、引き継がれます。
[値の保存場所](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/context.md#where-values-are-saved)を参照してください。

1. `xbox upgrade` に表示されるリリース ページ、または
   [GitHub Releases ページ](https://github.com/xbox/cli/releases/latest)から新しいリリースのアーカイブをダウンロードし、
   新しいディレクトリに展開します。
2. 実行中の `xbox` プロセスをすべて終了します。
3. 古いインストール ディレクトリを同じパスで新しいディレクトリに置き換えるか、
   [Windows (PowerShell)](#windows-powershell) または
   [Linux と macOS (Bash または Zsh)](#linux-and-macos-bash-or-zsh) の手順のように、`PATH` のエントリを新しいディレクトリに変更します。
4. 新しいターミナルを開き、`xbox --version` に新しいバージョンが表示されることを確認します。

新しいバージョンが動作するまで、古いディレクトリは `PATH` から外した状態で保持しておいてください。サインインの有効期限が切れている場合は、
もう一度 `xbox auth login` を実行します。

## 次のステップ

* [はじめに](https://docs.xbox.com/ja-jp/tools/xbox-cli/getting-started.md): サインインし、パートナー センターの販売者を選択して、その
  ゲームを一覧表示します。
* [コマンド](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands.md): コマンドの完全なリファレンスです。
* [テレメトリ](https://docs.xbox.com/ja-jp/tools/xbox-cli/telemetry.md): CLI が収集する内容と、収集を無効にする方法です。


## Related topics

- [ストリーミング インストール用のツール (目次)](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/deployment/atoc-deployment-tools.md)
- [ストリーミング インストール: デバッグ](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/packaging-debugging.md)
- [ストリーミング インストール: ステータス](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/packaging-installstatus.md)
- [インストールの属性設定](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/client/advertising/attribute-install.md)
- [Microsoft GDK をインストールせずに使用する (目次)](https://docs.xbox.com/ja-jp/build/console-features/build-without-install/gc-usingwithoutinstall-toc.md)
