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. Passez ensuite à
É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
Effectuez l’installation à 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 à partir de la page GitHub Releases :
Le fichier binaire Linux x64 nécessite glibc 2.27 ou une version ultérieure. Les fichiers binaires macOS sont signés par Microsoft et
notariés par Apple. Vous n’avez pas besoin d’installer .NET.
Extrayez l’archive complète dans un nouveau répertoire qui lui est propre, et 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. À partir de la recherche Windows, ouvrez Modifier les variables d’environnement pour votre compte. Sous Variables utilisateur, modifiez Path, sélectionnez Nouveau et entrez 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 elle affiche une version plus ancienne, une autre copie de xbox figure en premier dans votre PATH. Trouvez-la avec
Get-Command xbox -All dans PowerShell ou type -a xbox dans Bash ou Zsh, et retirez-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 à part de l’installation; ils sont donc conservés. Consultez Emplacement des valeurs enregistrées.- Téléchargez l’archive de la nouvelle version à partir de la page de version qu’affiche
xbox upgrade, ou à partir de la page GitHub Releases, et 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
votre entrée
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 recueille, et comment la désactiver.
