> ## 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.

# Instalação

> Baixe e instale a CLI para Windows, Linux ou macOS.

Instale a XBOX CLI com o WinGet no Windows, com o script de instalação no Linux ou no macOS, ou a partir de
um arquivo de versão em qualquer plataforma. Para compilá-la a partir do código-fonte, consulte
[Building from source](https://github.com/xbox/cli/blob/v0.4.2/docs/contributing/building-from-source.md).

## Windows: instalar com o WinGet

No Windows, instale a CLI com o [WinGet](https://learn.microsoft.com/windows/package-manager/winget/),
o Gerenciador de Pacotes do Windows:

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

O WinGet adiciona `xbox` ao seu `PATH` e não precisa de direitos de administrador. Se o terminal não encontrar
`xbox` após a instalação, abra um novo terminal ou reinicie o IDE, se você usar o terminal
integrado dele.

Para atualizar a CLI:

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

Para removê-la:

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

A desinstalação mantém suas configurações salvas e seus dados de login em `%LOCALAPPDATA%\XboxDevCLI`. Atualize uma
instalação do WinGet somente com o WinGet, não com as etapas de ZIP desta página. Continue com
[Próximas etapas](#next-steps).

## Linux e macOS: instalar com um script

No Linux x64 ou no macOS, o script de instalação baixa a versão mais recente em
`~/.local/opt/xboxdevcli` e adiciona esse diretório ao seu `PATH` no arquivo de inicialização do shell.
Ele precisa de `curl` e `unzip`:

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

O script imprime o arquivo de inicialização que ele alterou. Abra um novo terminal e verifique a versão com
`xbox --version`. Para atualizar a CLI, execute o script novamente. Para removê-la, exclua
`~/.local/opt/xboxdevcli` e a linha que o script adicionou a esse arquivo de inicialização.

## Baixar uma versão

Instale a partir de um arquivo de versão quando o WinGet e o script de instalação não forem adequados, como em um
PC com Windows sem o WinGet.

Baixe o arquivo para o seu sistema operacional e a sua CPU na
[página GitHub Releases](https://github.com/xbox/cli/releases/latest):

| Plataforma | Ativo | Binário |
| - | - | - |
| Windows x64 | `xbox-win-x64.zip` | `xbox.exe` |
| Linux x64 | `xbox-linux-x64.zip` | `xbox` |
| macOS no Apple silicon | `xbox-osx-arm64.zip` | `xbox` |
| macOS no Intel | `xbox-osx-x64.zip` | `xbox` |

O binário do Linux x64 requer a glibc 2.27 ou posterior. Os binários do macOS são assinados pela Microsoft e
autenticados pela Apple. Você não precisa instalar o .NET.

Extraia o arquivo inteiro em um novo diretório próprio e adicione esse diretório ao seu `PATH`,
conforme mostram as etapas da sua plataforma. Se o diretório já contiver uma instalação, siga
[Atualizar uma instalação via ZIP](#update-a-zip-installation).

## Windows (PowerShell)

1. Extraia o arquivo e verifique o executável extraído:

   ```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. Adicione o diretório ao seu `PATH`. Na Pesquisa do Windows, abra **Edit environment variables for
   your account**. Em **User variables**, edite **Path**, selecione **New** e insira o
   diretório, como `C:\Users\<you>\AppData\Local\Programs\XboxDevCLI`.

3. Abra um novo terminal e verifique a versão:

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

## Linux e macOS (Bash ou Zsh)

1. Extraia o arquivo e verifique o executável extraído. Este exemplo usa o Linux x64; no
   macOS, use `xbox-osx-arm64.zip` no Apple silicon ou `xbox-osx-x64.zip` no Intel:

   ```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. Adicione o diretório ao seu `PATH`. Adicione esta linha a `~/.zshrc` para o Zsh, o shell padrão no
   macOS, ou a `~/.bashrc` para o Bash:

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

3. Abra um novo terminal e verifique a versão:

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

## Verificar a instalação

`xbox --version` mostra a versão que você baixou, sem o `v` inicial da tag.
Se ele mostrar uma versão mais antiga, outra cópia de `xbox` vem primeiro no seu `PATH`. Encontre-a com
`Get-Command xbox -All` no PowerShell ou `type -a xbox` no Bash ou no Zsh e remova-a do seu
`PATH`.

## Verificar se há atualizações

`xbox upgrade` informa se há uma versão mais recente e como instalá-la. Consulte
[Upgrade](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/upgrade.md).

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

Para atualizar uma instalação do WinGet, execute `winget upgrade Microsoft.Gaming.XBOXDeveloperCLI`. Para
atualizar uma instalação via script, execute o [script de instalação](#linux-and-macos-install-with-a-script)
novamente. Para atualizar uma instalação via ZIP, siga a próxima seção.

## Atualizar uma instalação via ZIP

Suas configurações salvas e seus dados de login são armazenados separadamente da instalação; portanto, eles são mantidos.
Consulte [Onde os valores são salvos](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context.md#where-values-are-saved).

1. Baixe o arquivo da nova versão na página da versão que `xbox upgrade` mostra ou na
   [página GitHub Releases](https://github.com/xbox/cli/releases/latest) e extraia-o
   em um novo diretório.
2. Feche todos os processos `xbox` em execução.
3. Substitua o diretório da instalação antiga pelo novo, no mesmo caminho, ou altere
   a entrada do seu `PATH` para o novo diretório, como em [Windows (PowerShell)](#windows-powershell) ou
   [Linux e macOS (Bash ou Zsh)](#linux-and-macos-bash-or-zsh).
4. Abra um novo terminal e verifique se `xbox --version` mostra a nova versão.

Mantenha o diretório antigo, fora do seu `PATH`, até que a nova versão funcione. Se o seu login tiver expirado,
execute `xbox auth login` novamente.

## Próximas etapas

* [Introdução](https://docs.xbox.com/pt-BR/tools/xbox-cli/getting-started.md): entre, escolha seu vendedor do Partner Center e liste os
  jogos dele.
* [Comandos](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands.md): a referência completa de comandos.
* [Telemetria](https://docs.xbox.com/pt-BR/tools/xbox-cli/telemetry.md): o que a CLI coleta e como desativar.


## Related topics

- [Atribuir instalação](https://docs.xbox.com/pt-BR/services/playfab/api-references/rest/client/advertising/attribute-install.md)
- [Instalação por streaming: status](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/packaging-installstatus.md)
- [Instalação por streaming: depuração](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/packaging-debugging.md)
- [Ferramentas para instalação por streaming](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/deployment/atoc-deployment-tools.md)
- [Usando o Microsoft GDK sem instalação (conteúdo)](https://docs.xbox.com/pt-BR/build/console-features/build-without-install/gc-usingwithoutinstall-toc.md)
