Vérifier la configuration minimale requise pour la version de Windows 10
Windows 10 version 18362 ou ultérieure est requis pour les tests de déploiement des packages basés sur MSIXVC.Évaluer vos besoins en matière d’empaquetage
Si votre package possède l’une des propriétés suivantes ou nécessite l’une des fonctionnalités suivantes, consultez la section Autres considérations relatives à l’empaquetage et fonctionnalités avancées plus loin dans cet article.- Dépendances des packages d’infrastructure Si votre application dépend de logiciels redistribuables, vous pouvez utiliser des versions préempaquetées de plusieurs de ces prérequis fournies par Microsoft, que vous pouvez déclarer comme dépendances et installer automatiquement.
- Actions d’installation personnalisées Si votre application dépend de logiciels redistribuables pour lesquels aucun package d’infrastructure n’est disponible, vous pouvez installer ces dépendances en chaîne.
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 MSIXVC ne prend pas en charge ou qui ne conviennent pas à une distribution dans des packages commerciaux.- Fichiers de base de données de programme (PDB).
- Fichiers d’empreinte de la plateforme Windows universelle (UWP) et APPX, notamment AppxSignature.p7x et AppxBlockMap.xml. Si vous avez déjà distribué votre titre en tant qu’application UWP dans le Microsoft Store, certains de ces fichiers pourraient être associés à votre package APPX ou MSIX. Supprimez ces fichiers.
- Toute référence à d’autres magasins de jeux PC : ressources, binaires, etc.
Obtenir les informations d’identité de votre produit dans Partner Center
Votre package 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 à partir de la page Game Setup | Identity pour 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, repérez les valeurs d’identité énumérées ci-dessus.
Créer votre fichier XML MicrosoftGame.config dans le dossier racine, puis créer le reste du contenu de votre jeu
Un exemple de fichier XML MicrosoftGame.config est inclus plus loin dans cet article. Utilisez cet exemple comme référence avec l’éditeur MicrosoftGame.config, qui simplifie la création de votre fichier .config et synchronise automatiquement les valeurs d’ID et de nom à partir de votre projet Partner Center.Identifier toutes les dépendances du runtime Visual C/C++
Identifiez toutes les dépendances du runtime Visual C/C++ de votre package. Assurez-vous qu’elles sont répertoriées comme dépendances dans votre MicrosoftGame.config ou qu’elles sont explicitement copiées dans la charge utile de votre package. Pour plus d’information, consultez Dépendances des packages d’infrastructure.Créer vos icônes pour l’affichage dans le shell et les packages du Store
Pour chaque image répertoriée dans l’exemple de MicrosoftGame.config suivant, placez un fichier correspondant dans le dossier racine de votre jeu, mis à l’échelle à la taille spécifiée. Vous pouvez aussi placer les ressources d’image dans un sous-répertoire et ajuster les chemins des 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, qui comprend 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 PromptsCréer votre fichier de mappage de 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>
Cette commande crée un fichier nommé layout.xml (ce nom de fichier est suggéré, mais vous pouvez utiliser tout autre nom). Utilisez ce fichier pendant l’étape d’empaquetage. Pour plus d’information sur les outils d’empaquetage, consultez Make package (makepkg.exe).
Utiliser Intelligent Delivery pour déterminer comment réduire la taille des installations
Pour savoir comment réduire la taille des installations en balisant le contenu dans votre fichier layout.xml, consultez Vue d’ensemble d’Intelligent Delivery. Envisagez d’utiliser Intelligent Delivery si vous avez des ressources localisées volumineuses ou du contenu qui ne doit pas être installé par défaut, mais qui doit être disponible au téléchargement lorsque votre jeu le déclenche.Créer votre package
Créez le package à l’aide de la commande suivante :MakePkg pack /f layout.xml /lt /d <Your_game_folder_name> /nogameos /pc /pd <Output_Folder_Name>
Pour les scénarios dépendant des licences, comme le magasin intégré au jeu et la version d’essai, utilisez makepkg avec l’ID de contenu réel. Partner Center génère cet ID de contenu réel la première fois qu’il ingère le package. Vous pouvez le trouver dans les détails du package soumis sur la page Packages.
Activer le mode développeur sur votre PC cible
- Ouvrez Paramètres.
- Entrez Développeur dans le champ de recherche. Parmi les options affichées, sélectionnez Utiliser les fonctionnalités de développement.
- Sélectionnez Mode développeur. Une boîte de dialogue s’affiche, indiquant que le système ajoute certaines fonctionnalités. Avant de passer à l’étape suivante, attendez la fin de ce processus.
Tester l’installation de votre application
Exécutez la commande suivante :Wdapp install <Your_Package.msixvc>
Le package doit se trouver sur un lecteur local de votre PC de développement ou dans un emplacement réseau mappé à une lettre de lecteur. L’installation à partir de partages UNC (Universal Naming Convention) n’est pas encore prise en charge. Si vous ne voyez pas de progression, vous pouvez ouvrir l’application Microsoft Store et afficher la progression dans la section Téléchargements et mises à jour, indiquée par une flèche pointant vers le bas dans le coin supérieur droit de l’application, le cas échéant. Vous pouvez également sélectionner les points de suspension (…), puis sélectionner Téléchargements et mises à jour.
Depuis le Microsoft Game Development Kit (GDK) de mars 2022, les packages MSIXVC s’installent dans le dossier [drive]:\XboxGames sous forme de fichiers plats que vous pouvez modifier et auxquels vous pouvez accéder directement. Vous pouvez configurer l’emplacement de ce lecteur à l’aide de Gestion des applications (wdapp.exe). Pour plus d’information sur les fonctionnalités de Flat File Install, consultez Vue d’ensemble de Flat File Install.
Préparer votre package final, puis le soumettre à Partner Center
Le package que vous avez créé à l’aide de la commande MakePkg.exe précédente utilisait le paramètre /LT, qui chiffre au moyen d’une clé de test ou de développement. Pour une sécurité maximale, exécutez de nouveau la commande MakePkg.exe avec l’indicateur/LK pour le chiffrer au moyen d’une clé stable, ou avec l’indicateur /L pour le chiffrer au moyen d’une clé unique. Utilisez /LK plutôt que /L, car les packages créés avec /LK peuvent servir aux comparaisons locales de taille delta et bénéficient des optimisations de téléversement delta lors de la soumission à Partner Center.
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. Bien que vous puissiez créer manuellement le fichier MicrosoftGame.config, la meilleure façon de créer ce fichier est d’utiliser l’éditeur MicrosoftGame.config. Cet outil facilite également la synchronisation des valeurs d’identité et d’ID directement à partir de votre projet Partner Center.Autres considérations relatives à l’empaquetage et fonctionnalités avancées
Packages d’infrastructure pour les dépendances logicielles courantes
Si votre application dépend d’un logiciel redistribuable et que ce logiciel est disponible dans le Microsoft Store sous forme de package d’infrastructure, déclarez une dépendance envers le package d’infrastructure au lieu d’installer en chaîne le redistribuable. Par exemple, si votre application utilise l’ancien runtime DirectX, qui était historiquement fourni au moyen du fichier dxsetup.exe redistribué à partir du site de téléchargement de Microsoft, déclarez une dépendance envers le package d’infrastructure en plus des dépendances standard envers Windows.Universal et Windows.Desktop, comme suit. Cette approche est préférable à l’installation directe du redistribuable au moyen d’une action d’installation personnalisée, car les packages d’infrastructure peuvent être mis à jour automatiquement par le Microsoft Store, tandis que les actions d’installation personnalisées nécessitent l’approbation d’un administrateur et génèrent des invites de confirmation pendant le processus d’installation.Prise en charge des mods
À partir du Microsoft Game Development Kit (GDK) de mars 2022, les mods sont pris en charge par défaut. Pour plus d’information, consultez Mods.Actions d’installation personnalisées
Si votre application dépend d’autres programmes d’installation (fichiers .exe ou .msi) qui doivent être installés en chaîne lors de l’installation de votre application, utilisez l’élément CustomInstallActions pour configurer cette étape. Pour les redistribuables, vérifiez si un package d’infrastructure est disponible et contient les prérequis dont vous avez besoin avant de décider d’utiliser un programme d’installation personnalisé pour des éléments comme le runtime VC ou les fichiers .exe ou .msi redistribuables de DirectX. Pour des instructions détaillées sur les actions d’installation personnalisées, consultez Actions d’installation personnalisées.Autorisations de capacités restreintes
En plus de configurer votre fichier MicrosoftGame.config pour qu’il comprenne les éléments appropriés, envoyez un courriel à votre gestionnaire de compte afin d’activer les autorisations permettant à votre titre d’utiliser les fonctionnalités suivantes.- Actions d’installation personnalisées (élément CustomInstallActions).
