Skip to main content
Flat File Install est une fonctionnalité d’installation du Microsoft Game Development Kit (GDK) pour PC, livrée avec les versions de mars 2022 du GDK et des Gaming Runtime Services (GRTS), qui aide à simplifier la façon dont les fichiers MSIXVC sont disposés sur le disque après leur installation. L’objectif de ces changements est de réduire les frictions pour les développeurs en rendant l’expérience du système de fichiers du GDK sur PC plus cohérente entre les flux de travail avec fichiers libres et avec paquets, et de se rapprocher des expériences traditionnelles du système de fichiers Win32.
Les paquets MSIXVC2 s’installent nativement sous forme de fichiers plats : aucune étape d’extraction n’est requise. Le comportement de Flat File Install décrit sur cette page s’applique au format MSIXVC d’origine. MSIXVC2 offre cette même expérience de fichiers plats par défaut. Pour plus d’information, consultez Vue d’ensemble de l’empaquetage MSIXVC2.

Changements au flux de travail des développeurs de jeux PC avec Flat File Install

Flat File Install modifie votre façon de travailler avec les paquets MSIXVC de quelques façons clés. Les voici :
  • Les paquets sont désormais installés par défaut dans un dossier XboxGames à la racine de votre système d’exploitation (c’est-à-dire C:\XboxGames). Ce comportement peut être configuré à l’aide des outils en ligne de commande wdapp gamefolder, en plus de l’indicateur /drive de la commande wdapp install. De plus, le dossier C:\XboxGames ne requiert pas d’autorisations élevées pour accéder aux dossiers et aux fichiers de jeu qu’il contient.
  • Tous les fichiers, à l’exception de l’exécutable, sont modifiables par défaut. Cela réduit également le coût du déchiffrement à l’exécution, ce qui profite aux performances du titre. Pour plus d’information, consultez Prise en charge des mods pour les titres GDK sur PC.
  • Les fichiers installés à partir d’un MSIXVC ressemblent davantage à une disposition de fichiers plats, tous les fichiers étant directement accessibles. Cela signifie qu’il n’existe plus de notion de virtualisation de paquet qui empêche l’écriture à la racine du jeu ou qui oblige à désactiver la virtualisation des écritures dans le système de fichiers ou dans le registre.
  • Comme les fichiers peuvent désormais être consultés et modifiés directement, les éléments suivants n’ont plus besoin d’être spécifiés dans le fichier MicrosoftGame.config et sont dépréciés.
    • ModFolder
    • EnableWritesToPackageRoot
    • DisableFilesystemWriteVirtualization
    • DisableRegistryWriteVirtualization
Si ces éléments sont présents dans un fichier MicrosoftGame.config mis à jour vers Game configVersion="1", une erreur s’affichera lorsque vous tenterez d’empaqueter votre titre. L’erreur affichera « The DesktopRegistration entries “modFolder”, “enableWritesToPackageRoot”, “disableRegistryWriteVirtualization” and “disableFilesystemWriteVirtualization” are deprecated in configVersion >= 1 ». Supprimer ces éléments du fichier MicrosoftGame.config résoudra ce problème. Pour plus d’information sur Game configVersion="1" et pour savoir si cela touche votre titre, consultez Détails de version de MicrosoftGame.config.

Avantages de Flat File Install pour les joueurs PC

Flat File Install permet aux joueurs de sélectionner le répertoire où leurs jeux sont installés au moyen de l’application XBOX (limité à un dossier par lecteur), de modifier (mod) les jeux installés, de déplacer des jeux d’un lecteur à l’autre au moyen de l’application XBOX et de réparer des jeux au moyen de l’application XBOX. Ces changements signifient que les joueurs auront un accès en lecture et en écriture à tous les fichiers de jeu, à l’exception des exécutables désignés dans le fichier MicrosoftGame.config, qui demeureront chiffrés. Ces changements répondent à des demandes de longue date des joueurs PC en rendant davantage de jeux modifiables et en facilitant la recherche et la gestion des fichiers de jeu.

Remarques

  • Flat File Install s’applique uniquement aux jeux GDK pour PC. Les jeux distribués dans le Microsoft Store avec d’autres modèles d’application (c’est-à-dire UWP) ne profiteront pas de ces avantages.
  • Si vous avez une automatisation qui dépend de l’analyse du chemin C:\Program Files\WindowsApps pour les installations MSIXVC, ce changement aura une incidence sur celle-ci, car tous les chemins pointeront désormais vers C:\XboxGames, sauf indication contraire au moyen de wdapp gamefolder.
  • Flat File Install sera appliqué à la plupart des titres actuellement en disponibilité générale (GA). Les futures mises à jour du GDK pour les GDK publiés précédemment permettront un contrôle plus direct de cette fonctionnalité grâce aux améliorations des outils wdapp présentes dans le GDK de mars 2022.

Voir aussi

Vue d’ensemble de l’empaquetage MSIXVC2 Prise en main de l’empaquetage pour PC Utilisation des outils du Microsoft Game Development Kit pour installer et lancer votre titre PC MicrosoftGame.config
Last modified on October 6, 2026