> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Packages
> Utilisez la nouvelle expérience Packages de Partner Center pour charger, valider, certifier et publier des builds de jeux XBOX et PC, ou basculez vers l'interface classique.
Cet article fournit un guide pour charger, valider, certifier et publier des builds de jeux à l'aide de la dernière expérience **Packages** de Partner Center. L'article [Packages (expérience classique)](/fr/publishing/game-publishing/concepts/packages-overview) reste disponible pendant la transition vers la nouvelle expérience. Microsoft désactivera l'expérience classique dans une version ultérieure. Pendant la préversion, le basculement entre les deux expériences n'affecte pas les packages ni les configurations existants.
## Basculer entre l'expérience par défaut et l'expérience classique
Partner Center permet de basculer à tout moment entre l'expérience par défaut et l'expérience classique.
* Le basculement n'affecte pas vos packages, votre état de certification, votre publication ni votre historique.
* Les deux expériences affichent les mêmes packages et soumissions.
* Utilisez le bouton bascule si vous rencontrez un problème ou devez consulter l'interface classique.
Utilisez la dernière expérience et partagez vos commentaires. Vos retours aident Microsoft à améliorer l'expérience.
## Vue d'ensemble de Packages
**Packages** est un emplacement unique pour gérer les packages de votre jeu.
| Action | Description |
| - | - |
| Charger votre build de jeu | Chargez vos packages dans Partner Center : packages XVC pour les consoles XBOX ou packages MSIXVC pour PC. |
| Examiner les erreurs de validation | Les erreurs de validation apparaissent automatiquement lorsque vous chargez un package. Vous corrigez les erreurs avant de soumettre votre build à la certification. |
| Soumettre à la certification | Soumettez votre build à la certification. |
| Tester avec un public restreint | Utilisez des versions d'évaluation (flights) pour tester votre build avec des équipes internes ou des partenaires avant une diffusion à grande échelle. |
| Publier pour les joueurs | Publiez votre build dans un sandbox de développement, ou dans le sandbox RETAIL après la certification. |
| Restaurer un build | Restaurez un build certifié précédent dans le sandbox RETAIL sans nouveau chargement ni nouvelle certification. |
### Terminologie et fonctionnalités de Packages
Utilisez la terminologie suivante pour comprendre les fonctionnalités disponibles dans Packages.
* **Galerie de branches (page Packages) :** la vue principale de la page **Packages**, qui affiche les branches du produit réparties entre **Draft** et **Live**.
* **Branche :** un conteneur pour les fichiers de package et leur configuration associée.
* **Menu de branche :** les options disponibles après avoir sélectionné **...** pour une branche spécifique. Selon la branche (Main ou autres), les options de menu peuvent inclure **View and Edit**, **Create Flight**, **Promote to Main** et **Delete**.
* **Historique :** le journal des actions effectuées dans des branches ou des flights spécifiques.
* **Certify :** l'option permettant de lancer la soumission à la certification XBOX.
* **Review and Publish :** l'option permettant de lancer la publication dans un sandbox de développement ou dans RETAIL.
## Branches : travailler sur plusieurs builds
Les branches vous permettent de travailler sur plusieurs versions de votre jeu en même temps sans qu'elles interfèrent entre elles. Considérez chaque branche comme un espace de travail distinct dédié à un objectif spécifique.
### Pourquoi utiliser des branches ?
* Certifier un build stable sur une branche tout en chargeant et en testant un autre build ailleurs.
* Tester des modifications risquées sans toucher à votre build en production.
* Créer une branche de correctif pour isoler les correctifs urgents du développement en cours.
* Préparer des variantes de localisation ou régionales de manière indépendante.
## Galerie de branches : brouillon et production
Lorsque vous ouvrez la page **Packages**, vous voyez deux vues : **Draft** et **Live**. Ces vues représentent différents états des branches.
### Vue Draft
La vue **Draft** est votre zone de travail active. **Draft** prend en charge le chargement de packages, la vérification de l'état de certification et la préparation des builds pour les tests ou la publication. La vue **Draft** comporte deux sections :
* **Branche principale :** affiche le brouillon de travail lié à votre version publique actuelle. Seule la branche principale peut être publiée dans RETAIL.
* **Branches supplémentaires :** affiche toutes les autres branches.
### Options de menu de la vue Draft
Chaque branche possède un menu (sélectionnez l'icône **...**) avec des actions propres à la branche.
| Type de branche | Actions disponibles |
| - | - |
| Branche principale | **View & Edit :** ouvre la branche pour charger et gérer des packages.
**Create flight :** crée un flight directement à partir de cette branche. |
| Branches supplémentaires (sandbox ou flight) | **View & Edit :** ouvre la branche pour charger et gérer des packages.
**Create flight :** crée un flight directement à partir de cette branche.
**Promote to main branch :** remplace l'intégralité du contenu de la branche Main par les packages de cette branche. Les packages précédents de Main sont définitivement supprimés et ne peuvent pas être récupérés.
**Delete :** supprime définitivement cette branche. |
### Vue Live
La vue **Live** affiche les packages publiés qui sont disponibles pour les joueurs. Cette vue inclut les packages publiés en disponibilité générale sur le Microsoft Store, les branches de flight actives et les branches de sandbox à l'état publié.
### Options de menu de la vue Live
Chaque branche possède un menu (sélectionnez l'icône **More options** (**…**)) qui comprend des actions propres à la branche.
| Type de branche | Actions disponibles |
| - | - |
| Branche principale (RETAIL) | **Rollback :** restaure instantanément un build précédemment certifié sans nouveau chargement ni nouvelle certification. La restauration est disponible sur la branche principale. |
| Branches de flight | **Promote to main branch :** remplace l'intégralité du contenu de la branche Main par les packages de cette branche. Les packages précédents de Main sont définitivement supprimés et ne peuvent pas être récupérés. |
| Branches de sandbox | **Promote to main branch :** remplace l'intégralité du contenu de la branche Main par les packages de cette branche. Les packages précédents de Main sont définitivement supprimés et ne peuvent pas être récupérés. |
Vous travaillez dans **Draft**. Les joueurs voient **Live**. Basculer entre les deux vues permet de distinguer clairement les builds en cours du contenu publié.
## Comment créer une branche
1. Ouvrez la page **Packages**.
2. Dans la vue **Draft**, sélectionnez **Add branch**.
3. Saisissez un **Name** (par exemple, Testing, Hotfix, Localization ou Experiment) et une **Description** pour la branche.
4. Une fois la branche créée, elle apparaît sous **Additional branches**.
## Afficher et modifier une branche
Lorsque vous ouvrez une branche à l'aide de **View & Edit**, vous accédez à la page **Edit branch**. Utilisez cette page pour gérer les packages de la branche.
### Barre d'actions supérieure
En haut de la page **Edit branch**, les actions suivantes sont disponibles.
| Bouton | Description |
| - | - |
| **History** | Ouvre un journal de toutes les activités de cette branche, y compris les soumissions à la certification, les événements de publication et les restaurations, ainsi que des détails sur l'auteur et la date de chaque action. |
| **Certify** | Soumet la branche à la certification XBOX une fois les packages complets et toutes les erreurs de validation corrigées. |
| **Save as draft** | Enregistre vos modifications sans soumettre la branche à la certification ni la publier. |
| **Review & publish** | Ouvre la page [Review and publish](/fr/publishing/game-publishing/concepts/modular-submission), où vous pouvez examiner la branche et publier des packages dans des sandbox de développement et dans **RETAIL**. |
### Détails de la branche
Vous pouvez également modifier les champs **Display name** et **Description** d'une branche.
* **Branch display name :** le nom affiché pour cette branche dans Partner Center.
* **Description :** une courte note qui décrit l'objectif de la branche, par exemple *À publier* ou *Correctif d'avril*.
## Fichiers de package requis : quoi charger
Lorsque vous chargez un build de jeu, certains fichiers sont obligatoires et d'autres facultatifs. La page **Edit branch** répertorie clairement chaque emplacement de fichier pour indiquer les fichiers que vous pouvez charger.
### Formats de package
Le format de votre package de jeu dépend de l'appareil cible. Le type de package que vous soumettez doit correspondre à la disponibilité par famille d'appareils que vous sélectionnez.
| Appareil | Qui peut télécharger | Format requis | Comment le créer |
| - | - | - | - |
| Console XBOX | Joueurs sur consoles XBOX | XVC | [Prise en main de l'empaquetage des titres pour les consoles XBOX](/fr/build/core-features/common/packaging/overviews/packaging-getting-started-for-console) |
| PC Windows | Appareils Windows 10 ou Windows 11 | MSIXVC | [Prise en main de l'empaquetage des jeux PC](/fr/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) |
Incrémentez toujours votre numéro de version pour chaque nouveau package. Utilisez l'attribut `Version` de l'élément `Identity` du fichier MicrosoftGame.Config. Vous pouvez utiliser le même numéro de version pour les packages de différentes plateformes, si vous le souhaitez. La certification XBOX peut rejeter des packages si vous n'incrémentez pas le numéro de version à chaque nouvelle soumission.
### Fichiers obligatoires
| Fichier | Description |
| - | - |
| Build empaqueté (.xvc/.msixvc) | Votre fichier de package principal contenant le build de jeu préparé. |
| Encryption Key Bundle (EKB) | Requis pour les packages MSIXVC et XVC. Garantit un chiffrement correct pour la distribution aux joueurs. Le chargement du package ne se poursuit pas tant que vous n'avez pas chargé ce fichier. |
### Fichiers facultatifs mais recommandés
| Fichier | Description | Quand vous en avez besoin |
| - | - | - |
| Symboles (.zip) | Permet un rapport complet des vidages sur incident pour le débogage. | Recommandé pour toutes les versions. |
| Fichier de disposition du disque (.xml) | Définit la structure du disque et l'ordre d'installation pour les versions sur disque. | Nécessaire uniquement pour les jeux sur disque ou multidisques. Non applicable aux jeux uniquement numériques. |
| Journal de Submission Validator (.xml) | Submission Validator est un composant du XBOX Game Development Kit (GDK) qui exécute une série de contrôles de qualité de base sur un package de jeu. Le résultat est un fichier journal XML contenant les résultats de la validation du package. Pour les packages destinés à la certification ou à la publication dans RETAIL, vous devez charger ce fichier dans Partner Center, et le journal doit soit afficher un résultat global de réussite, soit vous devez disposer d'une exception approuvée pour chaque problème marqué comme **failure**. Vous devez également vérifier dans le fichier journal les problèmes marqués comme **warning** et vous assurer que ces avertissements sont attendus. Assurez-vous toujours d'utiliser la [dernière version de Submission Validator](https://aka.ms/currentsubvalzip) (remarque : ce lien télécharge le dernier dossier zip). Une erreur accompagnée d'instructions de mise à jour s'affiche dans le journal si la version que vous utilisez a expiré. Des résultats de validation en ligne s'affichent si des avertissements ou des erreurs sont présents dans le journal. | Requis pour les packages soumis à la certification ou publiés dans RETAIL. |
| State Object Database (SODB) | Un fichier SODB contient une collection d'objets d'état de pipeline (PSO) D3D12 capturés à partir de votre jeu. Lorsqu'il est soumis avec votre package dans XBOX Partner Center, Microsoft compile ces objets d'état hors ligne dans une base de données de nuanceurs précompilés (PSDB) optimisée pour chaque combinaison GPU/pilote. Les PSDB sont fournies automatiquement aux joueurs via Windows Update ou le Microsoft Store. Cela réduit ou élimine la compilation des nuanceurs à l'exécution, qui peut entraîner de longs temps de chargement et des saccades en jeu sur PC. | Recommandé pour tous les packages PC pour lesquels vous souhaitez éliminer les saccades liées à la compilation des nuanceurs et réduire les temps de chargement. |
Le fichier de disposition du disque est différent du fichier layout.xml généré par l'outil **makepkg**, qui spécifie la disposition des blocs du package. Ne chargez pas ce fichier layout.xml comme disposition du disque.
## Validations des packages : détecter les problèmes avant la certification
Partner Center valide automatiquement les packages lorsque vous les chargez. Les validations vérifient que votre package est complet et prêt pour la certification ou la publication. Résoudre les problèmes à ce stade réduit le risque de rejet et d'échec à la certification.
* Toutes les erreurs de validation des branches et des packages s'affichent directement dans l'interface.
* Les fichiers requis sont validés automatiquement. Les fichiers EKB et journal de Submission Validator doivent être présents.
* Si le journal de Submission Validator contient des avertissements ou des erreurs, ils s'affichent clairement en ligne pour que vous puissiez les examiner.
* Si vous configurez des packages propres à un marché, la configuration de chaque variante est validée avant que la publication ne soit autorisée.
## Packages par défaut : charger et gérer des fichiers
La section Default packages permet d'assembler les packages d'une branche. Les packages par défaut sont disponibles sur tous les marchés. Les [packages propres à un marché](#market-specific-packages-and-regional-variants) pour des pays ou régions individuels sont chargés et gérés séparément.
### Options de chargement
* **Import :** copie des packages d'une autre branche dans celle-ci sans nouveau chargement. Le bouton **Import** apparaît en haut de la section **Default packages**, à côté de **Upload package**.
* **Upload package :** chargez des fichiers de jeu en faisant glisser-déposer un ou plusieurs fichiers, ou en utilisant **Browse files** pour une sélection individuelle. Le système détecte et classe automatiquement les fichiers dans les emplacements appropriés.
### Icônes d'état des packages
| État | Signification | Que faire |
| - | - | - |
| Passed | Le package a réussi la certification. | Aucune action requise : prêt à publier. |
| Certify | Le package n'est pas prêt pour la certification : validation incomplète ou fichiers manquants. | Corrigez d'abord toutes les erreurs de validation. |
| Failed | Le package a échoué à la certification. | Corrigez les problèmes et chargez un nouveau build. |
| Passed with notes | Le package a réussi mais comporte des avertissements. | Examinez les remarques : une action peut être nécessaire avant la prochaine soumission. |
| Icône Supprimer | Supprime définitivement ce fichier de package de la branche. | À utiliser avec prudence : cette action est irréversible. |
## Packages propres à un marché et variantes régionales
La section **Market-specific packages** affiche toutes les variantes régionales configurées pour les marchés sélectionnés. Cette section s'applique lorsque vous avez besoin de builds différents pour répondre à des exigences propres à un pays/une région ou réglementaires.
### Actions disponibles
* **Import** : copie des packages d'une autre branche dans un groupe de marchés spécifique.
* **Add market-specific package :** crée une nouvelle variante régionale pour un groupe de marchés.
* Chaque groupe de marchés (par exemple, Allemagne) dispose d'un menu à trois points (**...**) avec les options **Edit** et **Delete**.
### Créer un nouveau groupe propre à un marché
1. Vérifiez que vous consultez la page **Edit branch** de la branche voulue.
2. Sélectionnez **Add market-specific package**.
3. Saisissez un **Market group name** (par exemple, Allemagne) en spécifiant un nouveau nom ou en sélectionnant un nom existant.
4. Chargez un package pour chaque groupe.
## Options avancées : précommande et planification des mises à jour de packages
En bas de la page **Edit branch**, la section Advanced options vous offre deux fonctionnalités : la configuration de la précommande à l'aide de packages d'espace réservé et la planification des dates de disponibilité des mises à jour de contenu (CU).
### Package d'espace réservé pour la précommande
Si vous configurez une date de précommande dans vos paramètres de tarification et de disponibilité, sélectionnez **Configure placeholder package(s) to enable pre-order** dans **Advanced options** et spécifiez la **Expected maximum file size** du package final. Cette valeur apparaît sur la page de détails du produit (PDP) de votre produit dans le Microsoft Store. Elle invite les clients qui précommandent à installer le produit sur un lecteur disposant de suffisamment d'espace disque pour le package complet. Ce processus garantit qu'un espace de stockage suffisant est disponible à la sortie du produit.
Au moins une semaine avant la date de sortie de votre produit, publiez un package mis à jour qui remplace l'espace réservé afin que les appareils des clients commencent à installer le package complet avant la sortie. Lorsque vous publiez le package mis à jour, décochez la case **Configure placeholder package(s) to enable pre-order**.
Contactez votre représentant Microsoft si vous prévoyez d'utiliser un package d'espace réservé.
### Planifier les mises à jour de packages
Les CU prennent en charge des dates de disponibilité personnalisées pour la diffusion aux joueurs. Sélectionnez **Configure availability date for my package(s)** pour activer la planification. Une fois cette option activée, définissez deux dates par package.
| Type de date | Ce qu'elle contrôle | Obligatoire ? |
| - | - | - |
| Date de disponibilité | Définit le moment où la CU devient obligatoire. Si la mise à jour n'est pas installée, le jeu ne peut pas être joué lorsqu'il est connecté au réseau XBOX. | Obligatoire pour les CU planifiées. |
| Date de prétéléchargement | Définit le moment où la mise à jour peut être téléchargée en arrière-plan sur les appareils où cette fonctionnalité est activée. Ce paramètre permet aux joueurs d'utiliser la mise à jour immédiatement à la date de disponibilité. | Facultative, mais recommandée. |
Définissez votre **date de prétéléchargement** au moins 48 heures avant la date de disponibilité. Ce délai laisse aux joueurs le temps de télécharger la mise à jour en arrière-plan et de jouer immédiatement le jour du lancement sans attendre.
### Que se passe-t-il selon les configurations de dates
* **Même date de prétéléchargement et de disponibilité :** pas de téléchargement anticipé, la mise à jour s'applique à cette date.
* **Aucune date de prétéléchargement définie :** la mise à jour n'est téléchargée qu'à la date de disponibilité.
* **Aucune date de disponibilité définie :** la mise à jour est disponible immédiatement après sa publication dans le sandbox RETAIL.
* **Packages propres à un marché :** définissez la disponibilité et le prétéléchargement indépendamment pour chaque marché.
## Flights : tester avec un public restreint
Utilisez des flights pour tester une branche avec un groupe restreint d'utilisateurs avant une publication à grande échelle. Cette méthode de test est utile pour les tests internes, les préversions destinées aux partenaires ou les groupes en accès anticipé.
### Comment créer un flight
1. Accédez à l'onglet **Flights** de la page **Packages**.
2. Sélectionnez **Create new flight**.
3. Saisissez un **nom** pour le flight et sélectionnez le **public** (groupes d'appareils ou d'utilisateurs).
4. Sélectionnez la **Branch** que vous souhaitez tester.
5. (Facultatif) Définissez des dates de **début** et de **fin**.
6. Sélectionnez **Save**. Le flight apparaît immédiatement dans votre liste de flights.
Vous pouvez également créer des flights directement à partir de la **Branch gallery**. Sélectionnez une branche et choisissez **Create Flight** dans le menu (icône **...**). La branche est présélectionnée et l'expérience est identique.
### Modifier un flight
Après avoir créé un flight, vous pouvez ajouter ou supprimer des groupes de public selon vos besoins. Le Microsoft Store reflète immédiatement ces modifications. Vous pouvez également modifier le classement des flights après leur création.
## Certification : faire approuver votre build
La certification XBOX vérifie que votre build répond à toutes les exigences de la plateforme avant que vous puissiez le publier pour les joueurs. Sélectionnez **Certify** pour une branche et suivez les invites pour soumettre votre build à la certification XBOX. Pour plus d'informations, consultez [Certifier un jeu](/fr/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game).
| Résultat | Description | Étape suivante |
| - | - | - |
| Pass | Le build répond à toutes les exigences. | Passez à la publication. |
| Certified with notes | Le build réussit avec des remarques. Des problèmes mineurs sont signalés. | Examinez les remarques et décidez de publier ou de corriger d'abord. |
| Fail | Le build ne répond pas aux exigences. | Corrigez les problèmes, chargez un nouveau build et soumettez-le à nouveau. |
| Not certified | Le package n'a pas encore été soumis à la certification et reste à l'état de brouillon. | Renseignez tous les champs et fichiers requis, corrigez les erreurs de validation, puis sélectionnez le bouton **Certify**. |
| Under review | La certification est en cours. Le package est en cours d'examen. | Attendez le résultat. Aucune modification n'est autorisée dans cette branche pendant l'examen. |
Avant de soumettre des packages à la certification, remplissez le [questionnaire de certification](/fr/publishing/game-publishing/concepts/certification/certification-supplemental-info) du produit en sélectionnant **Certification** dans la navigation de la page du produit.
## Restauration : récupérer après une mauvaise version
Lorsqu'un build publié cause des problèmes aux joueurs, vous pouvez restaurer un build précédemment certifié sans nouveau chargement ni nouvelle certification. Dans **Packages**, vous pouvez déclencher une restauration à deux endroits.
### Comment effectuer une restauration
Depuis la **vue Draft (branche principale)**, procédez comme suit pour restaurer un package.
1. Ouvrez le menu de la **Main Branch** (icône **...**).
2. Sélectionnez **Rollback** parmi les options du menu. Cette option vous donne un accès rapide à **Rollback** sans changer de vue.
Depuis la **vue Live (menu de la branche principale)**, procédez comme suit pour restaurer un package.
1. Accédez à la **vue Live** de la page **Packages**.
2. Recherchez la **Main Branch** sous **In the Microsoft Store**.
3. Ouvrez le menu de la branche (icône **...**) et sélectionnez **Rollback**. Utilisez ce point d'entrée lorsque vous souhaitez d'abord voir l'état actuellement publié avant de décider quel build restaurer.
### Que se passe-t-il lors d'une restauration
Lorsque vous sélectionnez **Rollback**, une fenêtre modale guidée s'ouvre et vous fait passer par quatre étapes avant d'apporter des modifications.
**Étape 1 - Sélectionner la publication précédente :** une liste des builds précédemment certifiés et publiés s'affiche. Sélectionnez le build que vous souhaitez restaurer. Chaque entrée indique la version du build, la date de certification et la personne qui l'a soumis pour vous aider à identifier le bon build.
**Étape 2 - Afficher les détails :** les détails complets du build sélectionné, tels que les noms de packages, les versions, les familles d'appareils et l'état de certification, s'affichent. Examinez attentivement ces informations pour confirmer qu'il s'agit du bon build avant de continuer.
**Étape 3 - Comparer les packages actuels et cibles :** une comparaison côte à côte du build actuellement en production et du build que vous êtes sur le point de restaurer s'affiche. Cette étape est essentielle : elle vous permet de voir exactement ce qui change pour les joueurs une fois la restauration terminée. Vérifiez qu'aucun build ou famille d'appareils important n'est perdu au cours du processus.
**Étape 4 - Confirmer et soumettre** Avant l'exécution de la restauration, vous confirmez explicitement que vous comprenez ce qui change. Après votre confirmation, la restauration est soumise et l'ancien build stable est mis en production immédiatement, sans nouveau chargement ni nouvelle certification.
Utilisez **History** pour trouver le build exact que vous souhaitez restaurer. **History** affiche toutes les activités de toutes les branches (chargements, soumissions à la certification, événements de publication, flights et restaurations), avec l'auteur et la date de chaque action.
## Voir aussi
* [Créer et charger un package de jeu](/fr/publishing/game-publishing/tutorial-xbox-managed/how-to-create-a-package)
* [Vue d'ensemble de l'empaquetage](/fr/build/core-features/common/packaging/overviews/packaging)
## Related topics
- [Packages](/publishing/game-publishing/concepts/game-package-management.md)
- [XPackageUninstallPackage](/reference/system/xpackage/functions/xpackageuninstallpackage.md)
- [XPackage](/reference/system/xpackage/xpackage_members.md)
- [XPackageEnumeratePackages](/reference/system/xpackage/functions/xpackageenumeratepackages.md)