Windows: instalar con WinGet
En Windows, instala la CLI con WinGet, el Administrador de paquetes de Windows:xbox a tu PATH y no necesita derechos de administrador. Si el terminal no encuentra
xbox después de la instalación, abre un terminal nuevo o reinicia tu IDE si usas su terminal
integrado.
Para actualizar la CLI:
%LOCALAPPDATA%\XboxDevCLI. Actualiza una
instalación de WinGet solo con WinGet, no con los pasos de ZIP de esta página. Continúa con
Pasos siguientes.
Linux y macOS: instalar con un script
En Linux x64 o macOS, el script de instalación descarga la versión más reciente en~/.local/opt/xboxdevcli y agrega ese directorio a tu PATH en el archivo de inicio de tu shell.
Necesita curl y unzip:
xbox --version. Para actualizar la CLI, vuelve a ejecutar el script. Para quitarla, elimina
~/.local/opt/xboxdevcli y la línea que el script agregó a ese archivo de inicio.
Descargar una versión
Instala desde un archivo de versión cuando WinGet y el script de instalación no sean adecuados, por ejemplo, en un PC con Windows sin WinGet. Descarga el archivo para tu sistema operativo y tu CPU desde la página de versiones de GitHub:
El binario de Linux x64 requiere glibc 2.27 o posterior. Los binarios de macOS están firmados por Microsoft y
certificados por Apple. No necesitas instalar .NET.
Extrae el archivo completo en un directorio nuevo propio y agrega ese directorio a tu
PATH,
como muestran los pasos de tu plataforma. Si el directorio ya contiene una instalación, sigue
Actualizar una instalación desde ZIP en su lugar.
Windows (PowerShell)
-
Extrae el archivo y comprueba el ejecutable extraído:
-
Agrega el directorio a tu
PATH. Desde Windows Search, abre Editar las variables de entorno de esta cuenta. En Variables de usuario, edita Path, selecciona Nuevo y escribe el directorio, comoC:\Users\<you>\AppData\Local\Programs\XboxDevCLI. -
Abre un terminal nuevo y comprueba la versión:
Linux y macOS (Bash o Zsh)
-
Extrae el archivo y comprueba el ejecutable extraído. Este ejemplo usa Linux x64; en
macOS, usa
xbox-osx-arm64.zipen Apple Silicon oxbox-osx-x64.zipen Intel: -
Agrega el directorio a tu
PATH. Agrega esta línea a~/.zshrcpara Zsh, el shell predeterminado en macOS, o a~/.bashrcpara Bash: -
Abre un terminal nuevo y comprueba la versión:
Comprobar la instalación
xbox --version muestra la versión que descargaste, sin la v inicial de la etiqueta.
Si muestra una versión anterior, hay otra copia de xbox antes en tu PATH. Búscala con
Get-Command xbox -All en PowerShell o type -a xbox en Bash o Zsh, y quítala de tu
PATH.
Buscar actualizaciones
xbox upgrade te indica si hay una versión más reciente y cómo instalarla. Consulta
Upgrade.
winget upgrade Microsoft.Gaming.XBOXDeveloperCLI. Para
actualizar una instalación con script, vuelve a ejecutar el script de instalación.
Para actualizar una instalación desde ZIP, sigue la sección siguiente.
Actualizar una instalación desde ZIP
La configuración guardada y los datos de inicio de sesión se almacenan aparte de la instalación, por lo que se conservan. Consulta Dónde se guardan los valores.- Descarga el archivo de la nueva versión desde la página de la versión que muestra
xbox upgrade, o desde la página de versiones de GitHub, y extráelo en un directorio nuevo. - Cierra los procesos de
xboxque estén en ejecución. - Reemplaza el directorio de instalación anterior por el nuevo, en la misma ruta, o cambia
la entrada de tu
PATHal nuevo directorio como en Windows (PowerShell) o Linux y macOS (Bash o Zsh). - Abre un terminal nuevo y comprueba que
xbox --versionmuestra la nueva versión.
PATH, hasta que la nueva versión funcione. Si tu inicio de sesión ha expirado,
vuelve a ejecutar xbox auth login.
Pasos siguientes
- Introducción: inicia sesión, elige tu vendedor de Partner Center y enumera sus juegos.
- Comandos: la referencia completa de comandos.
- Telemetría: qué recopila la CLI y cómo desactivarla.
