Windows: instalar com o WinGet
No Windows, instale a CLI com o WinGet, o Gerenciador de Pacotes do Windows: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:
%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.
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:
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:
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.
Windows (PowerShell)
-
Extraia o arquivo e verifique o executável extraído:
-
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, comoC:\Users\<you>\AppData\Local\Programs\XboxDevCLI. -
Abra um novo terminal e verifique a versão:
Linux e macOS (Bash ou Zsh)
-
Extraia o arquivo e verifique o executável extraído. Este exemplo usa o Linux x64; no
macOS, use
xbox-osx-arm64.zipno Apple silicon ouxbox-osx-x64.zipno Intel: -
Adicione o diretório ao seu
PATH. Adicione esta linha a~/.zshrcpara o Zsh, o shell padrão no macOS, ou a~/.bashrcpara o Bash: -
Abra um novo terminal e verifique a versão:
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.
winget upgrade Microsoft.Gaming.XBOXDeveloperCLI. Para
atualizar uma instalação via script, execute o script de instalação
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.- Baixe o arquivo da nova versão na página da versão que
xbox upgrademostra ou na página GitHub Releases e extraia-o em um novo diretório. - Feche todos os processos
xboxem execução. - Substitua o diretório da instalação antiga pelo novo, no mesmo caminho, ou altere
a entrada do seu
PATHpara o novo diretório, como em Windows (PowerShell) ou Linux e macOS (Bash ou Zsh). - Abra um novo terminal e verifique se
xbox --versionmostra a nova versão.
PATH, até que a nova versão funcione. Se o seu login tiver expirado,
execute xbox auth login novamente.
Próximas etapas
- Introdução: entre, escolha seu vendedor do Partner Center e liste os jogos dele.
- Comandos: a referência completa de comandos.
- Telemetria: o que a CLI coleta e como desativar.
