Vérifier la configuration minimale requise pour la version de Windows 10
Windows 10 version 18362 ou ultérieure est requis pour tester le déploiement des packages basés sur MSIXVC.Évaluer vos besoins en matière d’empaquetage
Si votre package présente 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 repose sur des logiciels redistribuables, vous pouvez utiliser des versions préempaquetées de bon nombre 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 repose sur des 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 livraison 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à publié en tant qu’application UWP dans le Microsoft Store, certains de ces fichiers peuvent être associés à votre package APPX ou MSIX. Supprimez ces fichiers.
- Toute référence à d’autres magasins de jeux PC : ressources, fichiers binaires, etc.
Obtenir les informations d’identité de votre produit à partir de 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 depuis la page Game Setup | Identity pour les utiliser dans votre fichier 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 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 depuis votre projet Partner Center.Identifier les dépendances du runtime Visual C/C++
Identifiez les dépendances du runtime Visual C/C++ de votre package. Assurez-vous qu’elles sont répertoriées comme dépendances dans votre fichier MicrosoftGame.config ou qu’elles sont explicitement copiées dans la charge utile de votre package. Pour plus d’informations, 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 fichier MicrosoftGame.config suivant, placez un fichier correspondant dans le dossier racine de votre jeu, mis à l’échelle à la taille spécifiée. Vous pouvez également placer les ressources d’images 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, qui 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 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 appelé layout.xml (ce nom de fichier est suggéré, mais vous pouvez utiliser n’importe quel autre nom). Utilisez ce fichier lors de l’étape d’empaquetage. Pour plus d’informations sur les outils d’empaquetage, consultez Créer un 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’évaluation, 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 le trouverez 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 pour indiquer que le système ajoute certaines fonctionnalités. Avant de poursuivre, attendez que ce processus se termine.
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 sur 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, signalé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 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 cet emplacement de lecteur à l’aide de Gestion des applications (wdapp.exe). Pour plus d’informations 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 à l’aide 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 à l’aide d’une clé stable, ou avec l’indicateur /L pour le chiffrer à l’aide d’une clé unique. Utilisez /LK plutôt que /L, car les packages créés avec /LK peuvent être utilisés pour des comparaisons locales de taille delta et bénéficient des optimisations de chargement delta lors de la soumission à Partner Center.
Exemple de fichier 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 le fichier MicrosoftGame.config manuellement, 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 depuis 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 repose sur un logiciel redistribuable et que ce logiciel est disponible dans le Microsoft Store en tant que package d’infrastructure, déclarez une dépendance au package d’infrastructure au lieu d’installer le redistribuable en chaîne. Par exemple, si votre application utilise l’ancien runtime DirectX, qui était historiquement fourni à l’aide du fichier dxsetup.exe redistribué depuis le site de téléchargement Microsoft, déclarez une dépendance au package d’infrastructure en plus des dépendances standard à Windows.Universal et Windows.Desktop, comme suit. Cette approche est préférable à l’installation directe du redistribuable à l’aide d’une action d’installation personnalisée, car les packages d’infrastructure peuvent être mis à jour automatiquement via 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’informations, consultez Mods.Actions d’installation personnalisées
Si votre application repose sur 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 les fichiers .exe ou .msi redistribuables du runtime VC ou de DirectX. Pour obtenir des instructions détaillées sur les actions d’installation personnalisées, consultez Actions d’installation personnalisées.Autorisations de fonctionnalités restreintes
En plus de configurer votre fichier MicrosoftGame.config pour qu’il inclue les éléments appropriés, envoyez un e-mail à 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).
