Skip to main content
Suivez les étapes ci-dessous pour créer un package XVC que vous pouvez charger de manière indépendante (sideload) pour le tester sur votre Microsoft Game Development Kit, puis soumettre à l’Espace partenaires (Partner Center) en vue de sa publication.

Obtenir les informations d’identité de votre produit dans Partner Center

Votre package fait référence à l’identité de produit attribuée à votre jeu dans Partner Center, notamment votre identité d’éditeur, PackageFamilyName, MSAAppId et TitleId. Configurez votre produit et récupérez ces informations sur la page Game Setup | Identity afin de les utiliser dans votre MicrosoftGame.config.
  1. Si ce n’est pas déjà fait, inscrivez-vous au programme ID@XBOX et créez un compte Partner Center.
  2. Créez une définition de produit initiale pour votre jeu dans Partner Center.
  3. Sur la page Game Setup | Identity de votre produit, recherchez les valeurs d’identité répertoriées ci-dessus.

Créer votre fichier MicrosoftGame.config dans le dossier racine avec le reste du contenu de votre jeu

Un exemple de fichier XML MicrosoftGame.config est fourni plus loin dans cet article. Utilisez cet exemple comme référence avec l’éditeur MicrosoftGame.config, qui peut simplifier la création de votre fichier .config et synchroniser automatiquement les valeurs d’ID et de nom depuis votre projet Partner Center.

Créer vos icônes pour l’affichage dans l’interface système et les packages Microsoft Store

Pour chaque image répertoriée dans l’exemple MicrosoftGame.config suivant, placez un fichier correspondant dans le dossier racine de votre jeu, mis à l’échelle à la taille indiquée. Vous pouvez également placer les ressources d’image dans un sous-répertoire et ajuster les chemins d’icônes ShellVisuals en conséquence. L’éditeur MicrosoftGame.config peut générer ces images pour vous à partir d’une seule image source.

Installer le Microsoft Game Development Kit (GDK) (inclut l’outil d’empaquetage makepkg.exe)

Par défaut, les invites de commandes du Microsoft Game Development Kit (GDK) se trouvent dans ce dossier : C:\Program Files (x86)\Microsoft GDK\Command Prompts

Créer votre fichier de mappage de la disposition d’empaquetage

Ouvrez une invite de commandes du Microsoft Game Development Kit (GDK) dans le dossier qui contient un seul dossier regroupant tout le contenu de votre jeu, puis exécutez la commande suivante : makepkg genmap /f layout.xml /d <Your_Game_Folder>

Créer votre package

Comment créer votre package

Suivez ces étapes pour créer un package chiffré avec /lk :
  1. Une seule fois : exécutez makepkg genkey /ekb SECRET_KEY.lekb pour créer le fichier SECRET_KEY.lekb. Ce fichier est le Local Escrowed Key Blob (LEKB) qui stocke la clé de contenu stable servant à chiffrer votre package. Conservez-le dans un emplacement sécurisé dont l’accès est limité aux personnes qui en ont besoin. Idéalement, seuls les ordinateurs et comptes de build officiels doivent y avoir accès.
  2. Création du package : exécutez makepkg pack /lk SECRET_KEY.lekb /f layout.xml /d <Your_Game_Folder_Name> /pd <Output_Folder_Name>. Cette commande crée un package chiffré à l’aide de la clé stockée dans le fichier SECRET_KEY.lekb.

Remarques importantes sur le chiffrement des packages

Le commutateur /lk de makepkg chiffre le package à l’aide d’une clé stable (toujours la même) créée par la commande makepkg genkey. En plus du package de votre titre, makepkg /lk génère des fichiers nommés au format PackageFullName_licenseName_GUID.EKB et PackageFullName_licenseName_GUID.CEKB. (Notez l’utilisation du caractère de soulignement (_).) Utilisez le chiffrement /lk pour les tests sur kit de développement et la soumission sur console. Il offre les avantages suivants par rapport au chiffrement de test (/lt) et au chiffrement de soumission (/l) :
  1. packageutil compare peut générer des estimations correctes de la taille des mises à jour (contrairement à /l).
  2. Il permet un chargement delta sécurisé vers Partner Center à l’aide du même algorithme que celui utilisé par les consoles et les PC pour télécharger les mises à jour de contenu.
  3. Vous pouvez l’installer sur des kits de développement (contrairement à /l).
  4. Il utilise des éléments de clé de chiffrement sécurisés et ne peut être déchiffré que dans des environnements spécifiques (contrairement à /lt).

Tester l’installation de votre package

Utilisez la commande suivante pour tester l’installation de votre package : xbapp install <Your_Package> Si votre package utilise des fonctionnalités Intelligent Delivery, utilisez l’option /i pour afficher l’interface utilisateur interactive du système permettant de choisir les fonctionnalités du package à installer, afin de tester l’expérience de l’utilisateur final en version commerciale. xbapp install /i <Your_Package>

Remarques importantes sur l’installation des packages

xbapp install installe automatiquement le fichier CEKB nécessaire pour charger le package sur un kit de développement XBOX. Si vous testez un scénario d’installation autre qu’une installation par outil (disque de jeu, stockage externe, transfert de console à console), la commande xbapp installkey peut être utilisée pour installer uniquement le fichier CEKB. Pour plus d’informations, consultez xbapp.exe.
Les fichiers LEKB générés avant le GDK d’avril 2021 ne créent pas de fichier CEKB. Pour utiliser la nouvelle fonctionnalité de chargement indépendant sur kit de développement, le fichier LEKB doit être recréé avec les outils du GDK d’avril 2021 ou ultérieur.

Si vous prévoyez de créer des disques pour votre package, consultez les articles suivants

Création de disques de compilation de test Création de disques de test intergénérationnels

Soumettre votre package à Microsoft Partner Center

Le package que vous avez créé avec la commande makepkg.exe précédente peut être utilisé à la fois pour les tests et pour la soumission, car l’indicateur /lk a été utilisé pour le chiffrer. Vous bénéficierez également du chargement delta lors du chargement de ce package. Les fichiers XVC et EKB sont chargés dans Partner Center comme d’habitude. Les fichiers LEKB et CEKB ne sont pas chargés.

Exemple de MicrosoftGame.config

Créez un fichier nommé MicrosoftGame.config. Utilisez le contenu suivant dans le répertoire racine du contenu de votre jeu, puis supprimez les commentaires des éléments dont vous n’avez pas besoin. Pour plus d’informations, consultez la page de référence MicrosoftGame.config. Bien que vous puissiez créer manuellement le fichier MicrosoftGame.config, la meilleure façon de le créer consiste à utiliser l’éditeur MicrosoftGame.config.

Articles connexes sur l’empaquetage

Prise en main de l’empaquetage des titres pour PC MicrosoftGame.Config Déploiement de votre titre sur votre kit de développement XBOX
Last modified on October 6, 2026