MSIXVC2 est disponible pour tous à partir du Microsoft Game Development Kit (GDK) d’octobre 2026. Vous pouvez charger de manière indépendante des packages MSIXVC2 à des fins de test et les soumettre à la certification en vue d’une publication publique.
Certaines fonctionnalités et améliorations de MSIXVC2 sont fournies au moyen de mises à jour des Gaming Runtime Services et ne nécessitent pas de mise à jour du GDK. Vous recevez automatiquement ces améliorations dès qu’elles sont disponibles.
Si vous créez des packages pour les consoles XBOX, consultez Prise en main de l’empaquetage pour les consoles XBOX. Les jeux sur console continuent d’utiliser XVC. L’outil
makepkg gère les deux formats.Avant de commencer
- Windows 10 version 18362 ou ultérieure sur votre PC de développement.
- GDK d’octobre 2026 ou ultérieur installé. Le GDK comprend
makepkg.exe.
À partir du GDK d’octobre 2026, l’outil d’empaquetage managé se nomme
makepkg.exe. L’ancien MakePkg.exe et le nom temporaire makepkg2.exe sont supprimés.- Produit Partner Center Vous avez besoin de votre identité d’éditeur, du nom du package et de l’ID Store.
- Mode développeur activé sur votre PC de test cible.
- Clé de registre du mode développeur MSIXVC2 définie sur tout appareil où vous installez ou exécutez des packages MSIXVC2. Consultez l’étape 7 pour plus de détails.
Étape 1 : Préparer votre contenu
Placez tout le matériel source de votre titre dans un seul répertoire. Supprimez tous les fichiers que le système d’empaquetage ne peut pas utiliser ou qui ne conviennent pas à une distribution dans des packages commerciaux. Supprimez les fichiers suivants s’ils sont présents :- Fichiers PDB.
- Toute référence à d’autres magasins de jeux PC, comme des ressources, des binaires, etc.
- Fichiers d’« empreinte » de la plateforme Windows universelle (UWP) et Appx, notamment AppxSignature.p7x et AppxBlockMap.xml.
Étape 2 : Créer votre MicrosoftGame.config
Créez un fichier MicrosoftGame.config dans le répertoire racine du contenu de votre jeu. Ce fichier de configuration fonctionne avec MSIXVC. Votre fichier MicrosoftGame.config existant fonctionne sans modification avec MSIXVC2. Vous pouvez créer ce fichier manuellement ou à l’aide de l’éditeur MicrosoftGame.config, qui synchronise les valeurs d’identité et d’ID directement à partir de votre projet Partner Center. Pour un exemple de fichier MicrosoftGame.config, consultez Prise en main de MSIXVC pour PC.Étape 3 : Identifier les dépendances du runtime Visual C/C++
Assurez-vous que votre MicrosoftGame.config répertorie toutes les dépendances du runtime Visual C/C++, ou copiez explicitement ces dépendances dans la charge utile de votre package. Pour plus d’information, consultez Dépendances des packages d’infrastructure.Étape 4 : Créer vos icônes
Placez les fichiers d’icônes dans le dossier racine du contenu de votre jeu (ou dans un sous-répertoire), mis à l’échelle selon les tailles spécifiées dans la sectionShellVisuals de votre MicrosoftGame.config. L’éditeur MicrosoftGame.config peut générer ces images à partir d’une seule image source.
Étape 5 : Générer un fichier de mappage de disposition (facultatif)
Cette étape est facultative. Par défaut, MSIXVC2 empaquette tout le contenu dans un seul bloc. Vous n’avez besoin d’un fichier de mappage de disposition que si vous souhaitez répartir le contenu en plusieurs blocs ou ajouter des balises Intelligent Delivery. Pour générer un fichier de mappage de disposition, ouvrez une invite de commandes GDK et exécutez la commande suivante :Étape 6 : Créer votre package MSIXVC2
Créez le package :Étape 7 : Tester votre package localement
Activez le mode développeur sur votre PC cible. Avant d’installer un package MSIXVC2, définissez la clé de registre suivante sur l’appareil cible :packageutil :
La commande
packageutil set nécessite le GDK d’octobre 2026 ou ultérieur.Cette clé de registre est requise jusqu’à une version future du GDK. Sans elle, les packages MSIXVC2 ne s’installeront pas. Exécutez la commande à partir d’une invite de commandes avec élévation de privilèges (administrateur).
[drive]:\XboxGames. Les fichiers sont installés dans leur forme originale et vous pouvez y accéder directement. Cet emplacement d’installation est le même que celui utilisé par les packages MSIXVC avec Flat File Install.
Vous pouvez téléverser dans Partner Center le même package que celui que vous chargez localement; il n’y a pas d’étape distincte de package de soumission.
Étape 8 : Téléverser dans Partner Center
Publiez les packages MSIXVC2 dans une nouvelle branche de Partner Center (par exemple,
msixvc2). Ne téléversez pas les packages MSIXVC2 dans la même branche que vos packages MSIXVC existants. Les deux formats ne sont pas interchangeables au sein d’une branche, et le retour d’une branche de MSIXVC2 à MSIXVC nécessite un téléversement et un téléchargement complets du package. Pour plus d’information, consultez Pratiques exemplaires relatives aux branches de packages.Option A : Téléverser un package préconstruit
Si vous avez déjà créé un package à l’étape 6, téléversez-le directement :Option B : Téléverser à partir de fichiers libres (flux de travail en une seule commande)
Vous pouvez combiner l’empaquetage et le téléversement en une seule commande. Cette commande téléverse directement à partir de la sortie de votre build sans créer de fichier de package local :Options de téléversement
Pour la liste complète des options de téléversement, consultez Make package (makepkg.exe).
Méthodes d’authentification
La commandeupload prend en charge plusieurs méthodes d’authentification pour différents environnements.
Exemple : téléversement à partir d’un pipeline CI/CD