> ## 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 dans Partner Center pour téléverser, valider, certifier et publier des builds de jeux XBOX et PC, ou passez à l'interface classique.
Cet article fournit un guide pour téléverser, valider, certifier et publier des builds de jeux à l'aide de la plus récente expérience **Packages** dans Partner Center. L'article [Packages (expérience classique)](/fr-CA/publishing/game-publishing/concepts/packages-overview) demeure accessible pendant la transition vers la nouvelle expérience. Microsoft désactivera l'expérience classique dans une version future. Pendant la préversion, le passage d'une expérience à l'autre n'a aucune incidence sur les packages ou les configurations existants.
## Passer de l'expérience par défaut à l'expérience classique
Partner Center permet de passer de l'expérience par défaut à l'expérience classique à tout moment.
* Le changement n'a aucune incidence sur vos packages, l'état de certification, la publication ou l'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 plus récente expérience et faites-nous part de vos commentaires. Vos commentaires aident Microsoft à améliorer l'expérience.
## Aperçu de Packages
**Packages** est un emplacement unique pour gérer les packages de votre jeu.
| Action | Description |
| - | - |
| Téléverser la build de votre jeu | Téléversez 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 s'affichent automatiquement lorsque vous téléversez 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 bac à sable de développement, ou dans le bac à sable RETAIL après la certification. |
| Restaurer une build | Restaurez une build certifiée antérieure dans le bac à sable RETAIL sans nouveau téléversement ni nouvelle certification. |
### Terminologie et fonctionnalités de Packages
Utilisez la terminologie suivante pour comprendre les fonctionnalités offertes dans Packages.
* **Galerie des branches (page Packages) :** La vue principale de la page **Packages**, qui montre 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 offertes après avoir sélectionné **...** pour une branche précise. Selon la branche (Main par rapport aux autres), les options du menu peuvent comprendre **View and Edit**, **Create Flight**, **Promote to Main** et **Delete**.
* **Historique :** Le journal des actions effectuées dans des branches ou des versions d'évaluation précises.
* **Certify :** L'option permettant de commencer la soumission à la certification XBOX.
* **Review and Publish :** L'option permettant de commencer la publication dans un bac à sable 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 les unes avec les autres. Considérez chaque branche comme un espace de travail distinct ayant un objectif précis.
### Pourquoi utiliser des branches?
* Certifier une build stable dans une branche tout en téléversant et en testant une autre build ailleurs.
* Tester des modifications risquées sans toucher à votre build en ligne.
* 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 façon indépendante.
## Galerie des branches : brouillon et en ligne
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** permet le téléversement 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 du menu de la vue Draft
Chaque branche possède un menu (sélectionnez l'icône **...**) comportant des actions propres à la branche.
| Type de branche | Actions offertes |
| - | - |
| Branche principale | **View & Edit :** Ouvre la branche pour téléverser et gérer des packages.
**Create flight :** Crée une version d'évaluation directement à partir de cette branche. |
| Branches supplémentaires (bac à sable ou version d'évaluation) | **View & Edit :** Ouvre la branche pour téléverser et gérer des packages.
**Create flight :** Crée une version d'évaluation directement à partir de cette branche.
**Promote to main branch :** Remplace tout le contenu de la branche Main par les packages de cette branche. Les packages précédents de Main sont supprimés de façon permanente et ne peuvent pas être récupérés.
**Delete :** Supprime cette branche de façon permanente. |
### Vue Live
La vue **Live** affiche les packages publiés qui sont accessibles aux joueurs. Cette vue comprend les packages publiés pour la disponibilité générale dans le Microsoft Store, les branches de versions d'évaluation actives et les branches de bac à sable à l'état publié.
### Options du 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 offertes |
| - | - |
| Branche principale (RETAIL) | **Rollback :** Restaure instantanément une build certifiée antérieure sans nouveau téléversement ni nouvelle certification. La restauration est offerte dans la branche principale. |
| Branches de versions d'évaluation | **Promote to main branch :** Remplace tout le contenu de la branche Main par les packages de cette branche. Les packages précédents de Main sont supprimés de façon permanente et ne peuvent pas être récupérés. |
| Branches de bac à sable | **Promote to main branch :** Remplace tout le contenu de la branche Main par les packages de cette branche. Les packages précédents de Main sont supprimés de façon permanente et ne peuvent pas être récupérés. |
Vous travaillez dans **Draft**. Les joueurs voient **Live**. Passer d'une vue à l'autre permet de bien distinguer 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. Entrez 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 êtes dirigé vers la page **Edit branch**. Utilisez cette page pour gérer les packages de la branche.
### Barre d'actions supérieure
Dans le haut de la page **Edit branch**, les actions suivantes sont offertes.
| Bouton | Description |
| - | - |
| **History** | Ouvre un journal de toute l'activité de cette branche, y compris les soumissions à la certification, les événements de publication et les restaurations, avec des détails sur qui a effectué chaque action et à quel moment. |
| **Certify** | Soumet la branche à la certification XBOX une fois que les packages sont complets et que toutes les erreurs de validation sont 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-CA/publishing/game-publishing/concepts/modular-submission), où vous pouvez examiner la branche et publier des packages dans des bacs à sable 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 l'ensemble de Partner Center.
* **Description :** Une courte note qui décrit l'objectif de la branche, par exemple, *To be released* ou *April hotfix*.
## Fichiers de package requis : quoi téléverser
Lorsque vous téléversez une build de jeu, certains fichiers sont obligatoires et d'autres sont facultatifs. La page **Edit branch** énumère clairement chaque emplacement de fichier pour indiquer quels fichiers vous pouvez téléverser.
### Formats de package
Le format du package de votre 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 de titres pour les consoles XBOX](/fr-CA/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 pour les jeux PC](/fr-CA/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` dans 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 pourrait rejeter des packages si vous n'incrémentez pas le numéro de version pour chaque nouvelle soumission.
### Fichiers obligatoires
| Fichier | Description |
| - | - |
| Build empaquetée (.xvc/.msixvc) | Votre fichier de package principal contenant la build de jeu préparée. |
| Encryption Key Bundle (EKB) | Requis pour les packages MSIXVC et XVC. Assure un chiffrement adéquat pour la distribution aux joueurs. Le téléversement du package ne se poursuit pas tant que vous n'avez pas téléversé ce fichier. |
### Fichiers facultatifs mais recommandés
| Fichier | Description | Quand vous en avez besoin |
| - | - | - |
| Symboles (.zip) | Permet des rapports complets de vidages sur incident pour le débogage. | Recommandé pour toutes les versions. |
| Fichier de disposition de 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 sur plusieurs disques. Ne s'applique pas 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 vérifications 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 téléverser 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 devriez également vérifier le fichier journal pour tout problème marqué comme **warning** et vous assurer que les avertissements sont attendus. Assurez-vous toujours d'utiliser la [plus récente version de Submission Validator](https://aka.ms/currentsubvalzip) (Remarque : ce lien télécharge le plus récent dossier zip). Une erreur accompagnée d'instructions de mise à jour s'affiche dans le journal si la version que vous utilisez est expirée. 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 livrées automatiquement aux joueurs au moyen de Windows Update ou du Microsoft Store. Cela réduit ou élimine la compilation des nuanceurs à l'exécution, qui peut causer de longs temps de chargement et des saccades en jeu sur PC. | Recommandé pour tous les packages PC pour lesquels vous voulez éliminer les saccades liées à la compilation des nuanceurs et réduire les temps de chargement. |
Le fichier de disposition de disque est différent du fichier layout.xml généré par l'outil **makepkg** qui précise la disposition des segments du package. Ne téléversez pas ce fichier layout.xml comme disposition de disque.
## Validations de package : détecter les problèmes avant la certification
Partner Center valide automatiquement les packages lorsque vous les téléversez. Les validations vérifient que votre package est complet et prêt pour la certification ou la publication. Corriger les problèmes à cette étape réduit le risque de rejet et d'échec à la certification.
* Toutes les erreurs de validation de branche et de package 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 à des marchés, la configuration de chaque variante est validée avant que la publication soit permise.
## Packages par défaut : téléverser et gérer des fichiers
La section Default packages permet d'assembler des packages pour une branche. Les packages par défaut sont offerts dans tous les marchés. Les [packages propres à des marchés](#market-specific-packages-and-regional-variants) pour des pays ou des régions individuels sont téléversés et gérés séparément.
### Options de téléversement
* **Import :** Copie des packages d'une autre branche dans celle-ci sans nouveau téléversement. Le bouton **Import** apparaît dans le haut de la section **Default packages**, à côté de **Upload package**.
* **Upload package :** Téléversez des fichiers de jeu en faisant glisser et en déposant 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 bons emplacements.
### 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 téléversez une nouvelle build. |
| Passed with notes | Le package a réussi, mais comporte des avertissements. | Examinez les remarques : une action pourrait être nécessaire avant la prochaine soumission. |
| Icône de suppression | Supprime de façon permanente ce fichier de package de la branche. | À utiliser avec prudence : cette action est irréversible. |
## Packages propres à des marchés 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érentes pour répondre à des exigences propres à un pays ou à une région, ou à des exigences réglementaires.
### Actions offertes
* **Import** : Copie des packages d'une autre branche dans un groupe de marchés précis.
* **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) possède un menu à trois points (**...**) comportant les options **Edit** et **Delete**.
### Créer un nouveau groupe propre à un marché
1. Confirmez que vous consultez la page **Edit branch** de la branche voulue.
2. Sélectionnez **Add market-specific package**.
3. Entrez un **Market group name** (par exemple, Allemagne) en précisant un nouveau nom ou en sélectionnant un nom existant.
4. Téléversez un package pour chaque groupe.
## Options avancées : précommande et planification des mises à jour de packages
Au bas de la page **Edit branch**, la section Advanced options vous offre deux fonctionnalités : la configuration de la précommande au moyen 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 Pricing and availability, sélectionnez **Configure placeholder package(s) to enable pre-order** dans **Advanced options** et précisez la taille de fichier maximale prévue (**Expected maximum file size**) pour le package final. Cette valeur apparaît dans la page de détails du produit (PDP) de votre produit dans le Microsoft Store. Elle indique aux clients qui précommandent d'installer le produit sur un lecteur disposant de suffisamment d'espace disque pour le package complet. Ce processus permet de s'assurer qu'un espace de stockage suffisant est disponible lors de 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**.
Communiquez avec votre représentant Microsoft si vous prévoyez 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 sortie auprès des 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é. | Facultatif, mais recommandé. |
Définissez votre **date de prétéléchargement** au moins 48 heures avant la date de disponibilité. Ce délai donne aux joueurs le temps de télécharger la mise à jour en arrière-plan et de commencer à jouer immédiatement le jour du lancement, sans attendre.
### Ce qui se passe selon les différentes configurations de dates
* **Même date de prétéléchargement et de disponibilité :** aucun téléchargement anticipé; la mise à jour s'applique à cette date.
* **Aucune date de prétéléchargement définie :** la mise à jour se télécharge uniquement à la date de disponibilité.
* **Aucune date de disponibilité définie :** la mise à jour est offerte immédiatement après sa publication dans le bac à sable RETAIL.
* **Packages propres à des marchés :** définissez la disponibilité et le prétéléchargement de façon indépendante pour chaque marché.
## Versions d'évaluation : tester avec un public restreint
Utilisez des versions d'évaluation (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 aperçus pour les partenaires ou les groupes d'accès anticipé.
### Comment créer une version d'évaluation
1. Accédez à l'onglet **Flights** de la page **Packages**.
2. Sélectionnez **Create new flight**.
3. Entrez un **nom** pour la version d'évaluation et sélectionnez le **public** (groupes d'appareils ou d'utilisateurs).
4. Sélectionnez la **Branch** que vous voulez tester.
5. (Facultatif) Définissez les dates de **début** et de **fin**.
6. Sélectionnez **Save**. La version d'évaluation apparaît immédiatement dans votre liste de versions d'évaluation.
Vous pouvez également créer des versions d'évaluation directement à partir de la **galerie des branches**. 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 une version d'évaluation
Après avoir créé une version d'évaluation, vous pouvez ajouter ou supprimer des groupes de public au besoin. Le Microsoft Store reflète immédiatement ces modifications. Vous pouvez également modifier le classement de la version d'évaluation après sa création.
## Certification : faire approuver votre build
La certification XBOX vérifie que votre build respecte toutes les exigences de la plateforme avant que vous puissiez la publier pour les joueurs. Sélectionnez **Certify** pour une branche et suivez les instructions pour soumettre votre build à la certification XBOX. Pour plus d'informations, consultez [Certifier un jeu](/fr-CA/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game).
| Résultat | Description | Étape suivante |
| - | - | - |
| Pass | La build respecte toutes les exigences. | Passez à la publication. |
| Certified with notes | La build réussit avec des remarques. Des problèmes mineurs sont signalés. | Examinez les remarques et décidez s'il faut publier ou corriger d'abord. |
| Fail | La build ne respecte pas les exigences. | Corrigez les problèmes, téléversez une nouvelle build et soumettez-la de nouveau. |
| Not certified | Le package n'a pas encore été soumis à la certification et demeure à l'état de brouillon. | Remplissez tous les champs et fichiers requis, corrigez les erreurs de validation, puis sélectionnez le bouton **Certify**. |
| Under review | La certification est actuellement en cours. Le package est en cours d'examen. | Attendez le résultat. Aucune modification n'est permise dans cette branche pendant l'examen. |
Avant de soumettre des packages à la certification, remplissez le [questionnaire de certification](/fr-CA/publishing/game-publishing/concepts/certification/certification-supplemental-info) du produit en sélectionnant **Certification** dans la navigation de la page du produit.
## Restauration : se remettre d'une mauvaise version
Lorsqu'une build publiée cause des problèmes aux joueurs, vous pouvez restaurer une build certifiée antérieure sans nouveau téléversement ni nouvelle certification. Dans **Packages**, vous pouvez déclencher une restauration à partir de deux endroits.
### Comment effectuer une restauration
À partir de la **vue Draft (branche principale)**, suivez ces étapes pour restaurer un package.
1. Ouvrez le menu de la **branche principale** (icône **...**).
2. Sélectionnez **Rollback** dans les options du menu. Cette option vous donne un accès rapide à **Rollback** sans changer de vue.
À partir de la **vue Live (menu de la branche principale)**, suivez ces étapes pour restaurer un package.
1. Accédez à la **vue Live** de la page **Packages**.
2. Trouvez la **branche principale** 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 voulez d'abord voir l'état actuellement publié avant de décider quelle build restaurer.
### Ce qui se passe lorsque vous effectuez 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 toute modification.
**Étape 1 - Sélectionner la publication précédente :** Vous voyez une liste des builds certifiées et publiées antérieurement. Sélectionnez la build que vous voulez restaurer. Chaque entrée indique la version de la build, la date de certification et la personne qui l'a soumise afin de vous aider à repérer la bonne.
**Étape 2 - Afficher les détails :** Les détails complets de la build sélectionnée, comme les noms de packages, les versions, les familles d'appareils et l'état de certification, sont affichés. Examinez attentivement ces renseignements pour confirmer qu'il s'agit de la bonne build avant de continuer.
**Étape 3 - Comparer les packages actuels et cibles :** Une comparaison côte à côte de la build actuellement en ligne et de la build que vous êtes sur le point de restaurer est affichée. 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'aucune build ou famille d'appareils importante n'est perdue 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. Une fois votre confirmation donnée, la restauration est soumise et l'ancienne build stable est mise en ligne immédiatement, sans nouveau téléversement ni nouvelle certification.
Utilisez **History** pour trouver la build exacte que vous voulez restaurer. **History** affiche toute l'activité dans l'ensemble des branches (téléversements, soumissions à la certification, événements de publication, versions d'évaluation et restaurations), avec qui a fait quoi et à quel moment.
## Voir aussi
* [Créer et téléverser un package de jeu](/fr-CA/publishing/game-publishing/tutorial-xbox-managed/how-to-create-a-package)
* [Aperçu de l'empaquetage](/fr-CA/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)