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.- Si ce n’est pas déjà fait, inscrivez-vous au programme ID@XBOX et créez un compte Partner Center.
- Créez une définition de produit initiale pour votre jeu dans Partner Center.
- 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ônesShellVisuals 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 :
- Une seule fois : exécutez
makepkg genkey /ekb SECRET_KEY.lekbpour créer le fichierSECRET_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. - 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) :
packageutil comparepeut générer des estimations correctes de la taille des mises à jour (contrairement à/l).- 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.
- Vous pouvez l’installer sur des kits de développement (contrairement à
/l). - 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érationnelsSoumettre 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.
