Windows : installer avec WinGet
Sous Windows, installez la CLI avec WinGet, le Gestionnaire de package Windows :xbox à votre PATH et ne nécessite aucun droit d’administrateur. Si le terminal ne trouve pas
xbox après l’installation, ouvrez un nouveau terminal, ou redémarrez votre IDE si vous utilisez son terminal
intégré.
Pour mettre à jour la CLI :
%LOCALAPPDATA%\XboxDevCLI. Mettez à jour une
installation WinGet uniquement avec WinGet, et non avec les étapes ZIP de cette page. Poursuivez avec
Étapes suivantes.
Linux et macOS : installer avec un script
Sous Linux x64 ou macOS, le script d’installation télécharge la dernière version dans~/.local/opt/xboxdevcli et ajoute ce répertoire à votre PATH dans le fichier de démarrage de votre shell.
Il nécessite curl et unzip :
xbox --version. Pour mettre à jour la CLI, exécutez de nouveau le script. Pour la supprimer, supprimez
~/.local/opt/xboxdevcli et la ligne que le script a ajoutée à ce fichier de démarrage.
Télécharger une version
Installez la CLI à partir d’une archive de version lorsque WinGet et le script d’installation ne conviennent pas, par exemple sur un PC Windows sans WinGet. Téléchargez l’archive correspondant à votre système d’exploitation et à votre processeur depuis la page GitHub Releases :
Le binaire Linux x64 nécessite glibc 2.27 ou version ultérieure. Les binaires macOS sont signés par Microsoft et
notariés par Apple. Vous n’avez pas besoin d’installer .NET.
Extrayez l’intégralité de l’archive dans un nouveau répertoire dédié, puis ajoutez ce répertoire à votre
PATH,
comme l’indiquent les étapes pour votre plateforme. Si le répertoire contient déjà une installation, suivez plutôt
Mettre à jour une installation ZIP.
Windows (PowerShell)
-
Extrayez l’archive et vérifiez l’exécutable extrait :
-
Ajoutez le répertoire à votre
PATH. Dans la recherche Windows, ouvrez Modifier les variables d’environnement pour votre compte. Sous Variables utilisateur, modifiez Path, sélectionnez Nouveau, puis saisissez le répertoire, par exempleC:\Users\<you>\AppData\Local\Programs\XboxDevCLI. -
Ouvrez un nouveau terminal et vérifiez la version :
Linux et macOS (Bash ou Zsh)
-
Extrayez l’archive et vérifiez l’exécutable extrait. Cet exemple utilise Linux x64 ; sous
macOS, utilisez
xbox-osx-arm64.zipsur Apple silicon ouxbox-osx-x64.zipsur Intel : -
Ajoutez le répertoire à votre
PATH. Ajoutez cette ligne à~/.zshrcpour Zsh, le shell par défaut sous macOS, ou à~/.bashrcpour Bash : -
Ouvrez un nouveau terminal et vérifiez la version :
Vérifier l’installation
xbox --version affiche la version que vous avez téléchargée, sans le v initial de l’étiquette.
Si une version plus ancienne s’affiche, une autre copie de xbox apparaît en premier dans votre PATH. Trouvez-la avec
Get-Command xbox -All dans PowerShell ou type -a xbox dans Bash ou Zsh, puis supprimez-la de votre
PATH.
Rechercher des mises à jour
xbox upgrade vous indique s’il existe une version plus récente et comment l’installer. Consultez
Upgrade.
winget upgrade Microsoft.Gaming.XBOXDeveloperCLI. Pour
mettre à jour une installation par script, exécutez de nouveau le script d’installation.
Pour mettre à jour une installation ZIP, suivez la section suivante.
Mettre à jour une installation ZIP
Vos paramètres enregistrés et vos données de connexion sont stockés séparément de l’installation : ils sont donc conservés. Consultez Emplacement d’enregistrement des valeurs.- Téléchargez l’archive de la nouvelle version depuis la page de version qu’affiche
xbox upgrade, ou depuis la page GitHub Releases, puis extrayez-la dans un nouveau répertoire. - Fermez tous les processus
xboxen cours d’exécution. - Remplacez votre ancien répertoire d’installation par le nouveau, au même chemin, ou modifiez
l’entrée de votre
PATHpour qu’elle pointe vers le nouveau répertoire, comme dans Windows (PowerShell) ou Linux et macOS (Bash ou Zsh). - Ouvrez un nouveau terminal et vérifiez que
xbox --versionaffiche la nouvelle version.
PATH, jusqu’à ce que la nouvelle version fonctionne. Si votre connexion a expiré,
exécutez de nouveau xbox auth login.
Étapes suivantes
- Prise en main : connectez-vous, choisissez votre vendeur Partner Center et répertoriez ses jeux.
- Commandes : la référence complète des commandes.
- Télémétrie : ce que la CLI collecte et comment le désactiver.
