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

# Package

> Répertoriez et obtenez les packages d'un jeu Partner Center, vérifiez si un build peut être utilisé dans un test de jeu, et découvrez comment en charger un.

Un package est un build d'un jeu que Partner Center a reçu et traité. Les commandes `package`
répertorient et obtiennent les packages d'un jeu, afin que vous puissiez vérifier si l'un d'eux est prêt pour un
[test de jeu](https://docs.xbox.com/fr/tools/xbox-cli/commands/playtest.md). Pour charger un package, consultez [Chargement de packages](#uploading-packages).

Ces commandes sont expérimentales : leurs options et leur sortie peuvent changer. Consultez
[Commandes expérimentales](https://docs.xbox.com/fr/tools/xbox-cli/cli-command-lifecycle.md). Elles nécessitent l'autorisation de lecture (Read) sur les packages (Packages)
de Partner Center pour le jeu, qu'inclut le rôle Developer.

## Commandes

| Commande | Description |
| - | - |
| `package list` | Répertorie les packages de la branche Main du jeu. |
| `package get <package-id>` | Obtient un package. |

## Arguments et options

| Argument ou option | S'applique à | Obligatoire | Description |
| - | - | - | - |
| `<package-id>` | `get` | Oui | ID du package, provenant de `package list`. |
| `--store-id <id>` | toutes | L'une des deux | ID Store du jeu, comme `9N0000000000`. |
| `--xbox-title-id <id>` | toutes | L'une des deux | ID de titre XBOX du jeu, et non son ID de titre PlayFab, comme `1234ABCD`. Lorsque l'ID de titre correspond à plusieurs jeux, la commande demande `--store-id`. |
| `--seller-id <id>` | toutes | Non | ID de vendeur Partner Center. |
| `--base-url <url>` | toutes | Non | URL de base des requêtes, qui remplace la clé de configuration `XboxPartner:BaseUrl`. |
| `--output <format>` | toutes | Non | `json` (par défaut), `json-compact` ou `table`. |

Le vendeur provient de `--seller-id` ou de votre vendeur enregistré ; consultez [Contexte](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md). Sans
vendeur, les commandes utilisent votre seul vendeur, et demandent `--seller-id` lorsque vous appartenez à plusieurs vendeurs.
`--xbox-title-id` a toujours besoin d'un vendeur.

## Liste des packages

```bash theme={null}
xbox package list --store-id 9N0000000000 --output json-compact
```

`package list` écrit l'ID de la branche Main du jeu et un tableau `packages` contenant tous les champs
que renvoie le service. `package get` écrit un package sous la même forme. Extrait :

```json theme={null}
{
  "packageSetId": "22222222-3333-4444-5555-666666666666",
  "packages": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "version": "1.0.0.0",
      "platform": "PC",
      "packageType": "Msixvc",
      "processingState": "Processed",
      "isAvailableForPlaytest": true,
      "validationItems": [],
      "fileName": "Nod.Arena_1.0.0.0_x64.msixvc",
      "createdAt": "2026-11-04T18:00:00Z"
    }
  ]
}
```

Un package est prêt pour un test de jeu lorsque toutes ces conditions sont remplies :

* `processingState` vaut `Processed`. Il passe de `PendingUpload` à `Uploaded` puis à
  `Processing`, et enfin à `Processed` ou à `ProcessFailed`.
* `validationItems`, les problèmes que Partner Center a détectés lors du traitement du package, ne contient aucun élément
  de gravité `Error`.
* `isAvailableForPlaytest` vaut `true`.

`--output table` comporte les colonnes `PACKAGE ID`, `VERSION`, `PLATFORM`, `STATE`, `PLAYTEST` et `CREATED`.
Elle n'affiche pas les résultats de validation : vérifiez donc `validationItems` dans le JSON.

## Chargement de packages

La CLI ne charge pas de packages. Chargez-les avec `makepkg` du kit de développement de jeux XBOX
(GDK) ; consultez la
[référence de makepkg](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/makepkg),
et pour les chargements depuis l'intégration continue (CI),
[Package Uploader](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/package-uploader).
Exécutez ensuite `package list` pour vérifier que le package est prêt.

## Erreurs

Les erreurs sont écrites sur stderr sous forme de texte, quel que soit `--output`, avec l'ID de corrélation. `--verbose` ajoute
le corps de la réponse. Un échec se termine avec le code `1`.

| Erreur | Action à effectuer |
| - | - |
| HTTP 401 | Reconnectez-vous avec `xbox auth login`. |
| HTTP 403, `package_permission_denied` | Vous ne disposez pas de l'autorisation de lecture (Read) sur les packages (Packages) du jeu pour ce vendeur. Demandez le rôle Developer à un responsable du compte Partner Center, ou passez `--seller-id` si le jeu appartient à un autre vendeur. |
| HTTP 403, `identity_override_not_authorized` | Vous n'appartenez pas à ce vendeur. Vérifiez le vendeur, et trouvez les vôtres avec `xbox seller list`. |
| HTTP 400, `seller_selection_required` | Vous appartenez à plusieurs vendeurs. Passez `--seller-id`. |
| HTTP 404, `game_not_found` | Le vendeur n'a aucun jeu avec cet ID Store. Vérifiez `--store-id` et `--seller-id`. |

## Exemples

```bash theme={null}
xbox package list --store-id 9N0000000000
xbox package list --xbox-title-id 1234ABCD --seller-id 1234567 --output table
xbox package get 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```


## Related topics

- [Packages](https://docs.xbox.com/fr/publishing/game-publishing/concepts/game-package-management.md)
- [XPackageUninstallPackage](https://docs.xbox.com/fr/reference/system/xpackage/functions/xpackageuninstallpackage.md)
- [XPackageEnumeratePackages](https://docs.xbox.com/fr/reference/system/xpackage/functions/xpackageenumeratepackages.md)
- [XPackageGetPackageKind](https://docs.xbox.com/fr/reference/system/xpackage/functions/xpackagegetpackagekind.md)
- [XPackageRegisterPackageInstalled](https://docs.xbox.com/fr/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
