> ## 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 une build peut être utilisée dans un test de jeu, et découvrez comment en téléverser une.

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

Ces commandes sont expérimentales : leurs options et leur sortie peuvent changer. Consultez
[Commandes expérimentales](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-command-lifecycle.md). Elles ont besoin de l'autorisation Lecture des packages de Partner Center
sur le jeu, qu'inclut le rôle Développeur.

## 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 a 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-CA/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.

## Répertorier les 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 le service retourne. `package get` écrit un package sous la même forme. Un 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` est `Processed`. Il passe de `PendingUpload` à `Uploaded`, puis à
  `Processing` et à `Processed`, ou à `ProcessFailed`.
* `validationItems`, soit les problèmes que Partner Center a trouvés pendant le traitement du package, ne contient aucun élément
  de gravité `Error`.
* `isAvailableForPlaytest` est `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 la sortie JSON.

## Téléverser des packages

La CLI ne téléverse pas de packages. Téléversez-les avec `makepkg` du Game Development Kit XBOX
(GDK); consultez la
[référence de makepkg](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/makepkg)
et, pour les téléversements à partir de 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, quelle que soit la valeur de `--output`, avec l'ID de corrélation. `--verbose` ajoute
le corps de la réponse. Un échec se termine avec le code `1`.

| Erreur | Que faire |
| - | - |
| HTTP 401 | Connectez-vous de nouveau avec `xbox auth login`. |
| HTTP 403, `package_permission_denied` | Vous n'avez pas l'autorisation Lecture des packages sur le jeu pour ce vendeur. Demandez le rôle Développeur à un gestionnaire du compte Partner Center, ou transmettez `--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 le vôtre avec `xbox seller list`. |
| HTTP 400, `seller_selection_required` | Vous appartenez à plusieurs vendeurs. Transmettez `--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-CA/publishing/game-publishing/concepts/game-package-management.md)
- [XPackageUninstallPackage](https://docs.xbox.com/fr-CA/reference/system/xpackage/functions/xpackageuninstallpackage.md)
- [XPackageEnumeratePackages](https://docs.xbox.com/fr-CA/reference/system/xpackage/functions/xpackageenumeratepackages.md)
- [XPackageGetPackageKind](https://docs.xbox.com/fr-CA/reference/system/xpackage/functions/xpackagegetpackagekind.md)
- [XPackageRegisterPackageInstalled](https://docs.xbox.com/fr-CA/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
