Skip to main content
Flat File Install 是 PC Microsoft 游戏开发工具包(GDK)的一项安装功能,于 2022 年 3 月 GDK 与 Gaming Runtime Services (GRTS) 版本一同发布,用于优化 MSIXVC 文件在安装后在磁盘上的布局方式。这些更改的目的是降低开发者的摩擦,让 PC 上 GDK 的文件系统体验在松散文件和打包工作流之间保持更一致,并更接近传统的 Win32 文件系统体验。
MSIXVC2 包原生以平面文件方式安装 —— 无需提取步骤。本页所述的 Flat File Install 行为适用于原始 MSIXVC 格式。MSIXVC2 默认提供相同的平面文件体验。有关详细信息,请参见 MSIXVC2 打包概述

Flat File Install 带来的 PC 游戏开发工作流变化

Flat File Install 从以下几个关键方面改变了你使用 MSIXVC 包的方式:
  • 包现在默认安装到操作系统根目录下的 XboxGames 文件夹中(即 C:\XboxGames)。除了 wdapp install 的 /drive 标志之外,还可以使用 wdapp gamefolder 命令行工具进行配置。此外,C:\XboxGames 文件夹中的游戏文件夹和文件不需要提升权限即可访问
  • 除可执行文件之外的所有文件默认均可修改。这还 降低了运行时解密开销,对游戏性能有益。有关详细信息,请参见 PC GDK 游戏的模组支持
  • 从 MSIXVC 安装的文件更接近平面文件布局,所有文件都可以直接访问。这意味着不再有阻碍向游戏根目录写入或需要禁用文件系统写入/注册表写入虚拟化的包虚拟化概念。
  • 由于文件现在可以直接访问和修改,以下元素不再需要在 MicrosoftGame.config 中指定,并已弃用。
    • ModFolder
    • EnableWritesToPackageRoot
    • DisableFilesystemWriteVirtualization
    • DisableRegistryWriteVirtualization
如果 MicrosoftGame.config 已更新至 Game configVersion="1" 但仍存在这些元素,在尝试打包你的游戏时会出现错误。错误将输出 “The DesktopRegistration entries “modFolder”, “enableWritesToPackageRoot”, “disableRegistryWriteVirtualization” and “disableFilesystemWriteVirtualization” are deprecated in configVersion >= 1”。从 MicrosoftGame.config 中移除这些元素即可解决问题。有关 Game configVersion="1" 的详细信息及其是否影响你的游戏,请参见 MicrosoftGame.config 版本详情

Flat File Install 对 PC 玩家的好处

Flat File Install 允许玩家通过 XBOX 应用选择游戏的安装目录(每个驱动器仅限一个文件夹),为已安装的游戏添加模组、通过 XBOX 应用跨驱动器移动游戏,以及通过 XBOX 应用修复游戏。这些变化意味着玩家将对所有游戏文件拥有读写访问权限 —— 但在 MicrosoftGame.config 中指定的可执行文件除外,它们仍保持加密状态。这些变化响应了 PC 玩家长期以来的需求,让更多游戏支持模组,并使查找和管理游戏文件更加容易。

备注

  • Flat File Install 仅适用于 PC GDK 游戏。以其他应用模型(即 UWP)在 Microsoft Store 上发布的游戏不会享受这些好处。
  • 如果你有任何自动化依赖于解析 MSIXVC 安装的 C:\Program Files\WindowsApps 路径,这一变更会影响它,因为除非通过 wdapp gamefolder 另行指定,否则所有路径现在都指向 C:\XboxGames。
  • Flat File Install 将应用于目前已 GA 的大多数游戏。之后的 GDK 更新将通过 2022 年 3 月 GDK 中已有的 wdapp 工具改进,允许对此功能进行更直接的控制。

另请参见

MSIXVC2 打包概述 PC 打包入门 使用 Microsoft 游戏开发工具包工具安装和启动你的 PC 游戏 MicrosoftGame.config
最后修改于 2026年8月24日