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

# Installation

> Téléchargez et installez la CLI pour Windows, Linux ou macOS.

Installez la XBOX CLI avec WinGet sous Windows, avec le script d'installation sous Linux ou macOS, ou à partir
d'une archive de version sur n'importe quelle plateforme. Pour la générer plutôt à partir du code source, consultez
[Building from source](https://github.com/xbox/cli/blob/v0.4.2/docs/contributing/building-from-source.md).

## Windows : installer avec WinGet

Sous Windows, installez la CLI avec [WinGet](https://learn.microsoft.com/windows/package-manager/winget/),
le Gestionnaire de package Windows :

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

WinGet ajoute `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 :

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

Pour la supprimer :

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

La désinstallation conserve vos paramètres enregistrés et vos données de connexion dans `%LOCALAPPDATA%\XboxDevCLI`. Mettez à jour une
installation WinGet uniquement avec WinGet, et non avec les étapes ZIP de cette page. Poursuivez avec
[Étapes suivantes](#next-steps).

## 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` :

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

Le script affiche le fichier de démarrage qu'il a modifié. Ouvrez un nouveau terminal et vérifiez la version avec
`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](https://github.com/xbox/cli/releases/latest) :

| Plateforme | Ressource | Binaire |
| - | - | - |
| Windows x64 | `xbox-win-x64.zip` | `xbox.exe` |
| Linux x64 | `xbox-linux-x64.zip` | `xbox` |
| macOS sur Apple silicon | `xbox-osx-arm64.zip` | `xbox` |
| macOS sur Intel | `xbox-osx-x64.zip` | `xbox` |

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](#update-a-zip-installation).

## Windows (PowerShell)

1. Extrayez l'archive et vérifiez l'exécutable extrait :

   ```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. 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 exemple `C:\Users\<you>\AppData\Local\Programs\XboxDevCLI`.

3. Ouvrez un nouveau terminal et vérifiez la version :

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

## Linux et macOS (Bash ou Zsh)

1. Extrayez l'archive et vérifiez l'exécutable extrait. Cet exemple utilise Linux x64 ; sous
   macOS, utilisez `xbox-osx-arm64.zip` sur Apple silicon ou `xbox-osx-x64.zip` sur 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. Ajoutez le répertoire à votre `PATH`. Ajoutez cette ligne à `~/.zshrc` pour Zsh, le shell par défaut sous
   macOS, ou à `~/.bashrc` pour Bash :

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

3. Ouvrez un nouveau terminal et vérifiez la version :

   ```bash theme={null}
   xbox --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](https://docs.xbox.com/fr/tools/xbox-cli/commands/upgrade.md).

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

Pour mettre à jour une installation WinGet, exécutez `winget upgrade Microsoft.Gaming.XBOXDeveloperCLI`. Pour
mettre à jour une installation par script, exécutez de nouveau le [script d'installation](#linux-and-macos-install-with-a-script).
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](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md#where-values-are-saved).

1. Téléchargez l'archive de la nouvelle version depuis la page de version qu'affiche `xbox upgrade`, ou depuis la
   [page GitHub Releases](https://github.com/xbox/cli/releases/latest), puis extrayez-la
   dans un nouveau répertoire.
2. Fermez tous les processus `xbox` en cours d'exécution.
3. Remplacez votre ancien répertoire d'installation par le nouveau, au même chemin, ou modifiez
   l'entrée de votre `PATH` pour qu'elle pointe vers le nouveau répertoire, comme dans [Windows (PowerShell)](#windows-powershell) ou
   [Linux et macOS (Bash ou Zsh)](#linux-and-macos-bash-or-zsh).
4. Ouvrez un nouveau terminal et vérifiez que `xbox --version` affiche la nouvelle version.

Conservez l'ancien répertoire, hors de votre `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](https://docs.xbox.com/fr/tools/xbox-cli/getting-started.md) : connectez-vous, choisissez votre vendeur Partner Center et répertoriez ses
  jeux.
* [Commandes](https://docs.xbox.com/fr/tools/xbox-cli/commands.md) : la référence complète des commandes.
* [Télémétrie](https://docs.xbox.com/fr/tools/xbox-cli/telemetry.md) : ce que la CLI collecte et comment le désactiver.


## Related topics

- [Attribuer l'installation](https://docs.xbox.com/fr/services/playfab/api-references/rest/client/advertising/attribute-install.md)
- [XPackageInstallationProgress](https://docs.xbox.com/fr/reference/system/xpackage/structs/xpackageinstallationprogress.md)
- [Installation en streaming : débogage](https://docs.xbox.com/fr/build/core-features/common/packaging/packaging-debugging.md)
- [Installation en streaming : état](https://docs.xbox.com/fr/build/core-features/common/packaging/packaging-installstatus.md)
- [XPackageGetInstallationProgress](https://docs.xbox.com/fr/reference/system/xpackage/functions/xpackagegetinstallationprogress.md)
