Skip to main content
Flat File Install est une fonctionnalité d’installation du Microsoft Game Development Kit (GDK) sur PC, fournie avec les versions de mars 2022 du GDK et de Gaming Runtime Services (GRTS), qui simplifie la disposition des fichiers MSIXVC sur le disque après leur installation. L’objectif de ces modifications 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 basés sur des fichiers libres et ceux basés sur des packages, et de se rapprocher des expériences traditionnelles du système de fichiers Win32.
Les packages 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’informations, consultez Vue d’ensemble de l’empaquetage MSIXVC2.

Modifications du flux de travail des développeurs de jeux PC avec Flat File Install

Flat File Install modifie votre façon de travailler avec les packages MSIXVC sur plusieurs points clés, à savoir :
  • Les packages sont désormais installés par défaut dans un dossier XboxGames à la racine du 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 d’installation wdapp. En outre, le dossier C:\XboxGames ne nécessite pas d’autorisations élevées pour accéder aux dossiers et 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’informations, 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 package empêchant l’écriture à la racine du jeu ou nécessitant la désactivation de la virtualisation des écritures dans le système de fichiers ou 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’affiche lors de la tentative d’empaquetage de votre titre. L’erreur affichée est « The DesktopRegistration entries “modFolder”, “enableWritesToPackageRoot”, “disableRegistryWriteVirtualization” and “disableFilesystemWriteVirtualization” are deprecated in configVersion >= 1 ». La suppression de ces éléments du fichier MicrosoftGame.config résout ce problème. Pour plus d’informations sur Game configVersion="1" et pour savoir si cela concerne votre titre, consultez Détails des versions de MicrosoftGame.config.

Avantages de Flat File Install pour les joueurs PC

Flat File Install permet aux joueurs de sélectionner le répertoire d’installation de leurs jeux via l’application XBOX (limité à un dossier par lecteur), d’appliquer des mods aux jeux installés, de déplacer des jeux entre lecteurs via l’application XBOX et de réparer des jeux via l’application XBOX. Ces modifications signifient que les joueurs disposeront d’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 resteront chiffrés. Ces modifications répondent à des demandes de longue date des joueurs PC en rendant davantage de jeux modifiables par des mods et en facilitant la recherche et la gestion des fichiers de jeu.

Remarques

  • Flat File Install s’applique uniquement aux jeux GDK sur PC. Les jeux distribués sur le Microsoft Store avec d’autres modèles d’application (c’est-à-dire UWP) ne bénéficieront pas de ces avantages.
  • Si vous disposez d’une automatisation qui dépend de l’analyse du chemin C:\Program Files\WindowsApps pour les installations MSIXVC, cette modification aura un impact, car tous les chemins pointeront désormais vers C:\XboxGames, sauf indication contraire avec wdapp gamefolder.
  • Flat File Install sera appliqué à la plupart des titres actuellement en disponibilité générale. Les futures mises à jour du GDK apportées aux 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