> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Flat File Install 概述

> Flat File Install 概述

Flat File Install 是 PC Microsoft 游戏开发工具包(GDK)的一项安装功能,于 2022 年 3 月 GDK 与 [Gaming Runtime Services (GRTS)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/intro/gaming-runtime-glossary) 版本一同发布,用于优化 MSIXVC 文件在安装后在磁盘上的布局方式。这些更改的目的是降低开发者的摩擦,让 PC 上 GDK 的文件系统体验在松散文件和打包工作流之间保持更一致,并更接近传统的 Win32 文件系统体验。

<Tip>**MSIXVC2** 包原生以平面文件方式安装 —— 无需提取步骤。本页所述的 Flat File Install 行为适用于原始 MSIXVC 格式。MSIXVC2 默认提供相同的平面文件体验。有关详细信息,请参见 [MSIXVC2 打包概述](/build/core-features/common/packaging/overviews/packaging-msixvc2-overview)。</Tip>

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

Flat File Install 从以下几个关键方面改变了你使用 MSIXVC 包的方式:

* 包现在默认安装到操作系统根目录下的 XboxGames 文件夹中(即 C:\XboxGames)。除了 `wdapp` install 的 /drive 标志之外,还可以使用 [wdapp gamefolder](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_gamefolder) 命令行工具进行配置。此外,**C:\XboxGames 文件夹中的游戏文件夹和文件不需要提升权限即可访问**。
* **除可执行文件之外的所有文件默认均可修改**。这还 **降低了运行时解密开销**,对游戏性能有益。有关详细信息,请参见 [PC GDK 游戏的模组支持](/build/core-features/common/packaging/packaging-mods)。
* 从 MSIXVC 安装的文件更接近平面文件布局,所有文件都可以直接访问。这意味着不再有阻碍向游戏根目录写入或需要禁用文件系统写入/注册表写入虚拟化的包虚拟化概念。
* 由于文件现在可以直接访问和修改,以下元素不再需要在 [MicrosoftGame.config](/reference/system/microsoftgameconfig/microsoftgameconfig-schema) 中指定,并已弃用。
  * ModFolder
  * EnableWritesToPackageRoot
  * DisableFilesystemWriteVirtualization
  * DisableRegistryWriteVirtualization

<Note>如果 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 版本详情](/reference/system/microsoftgameconfig/microsoftgameconfig-schema#MicrosoftGameConfig-VersionDetails)。</Note>

## 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 打包概述](/build/core-features/common/packaging/overviews/packaging-msixvc2-overview)
[PC 打包入门](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC)
[使用 Microsoft 游戏开发工具包工具安装和启动你的 PC 游戏](/tools/tools-pc/launching-on-pc)
[MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc)


## Related topics

- [MSIXVC2 加密模型](/zh-CN/build/core-features/common/packaging/packaging-encryption-msixvc2.md)
- [Social Manager 概述](/zh-CN/services/xbox-services/community/social-manager/live-social-manager-overview.md)
- [XGameSaveFiles API 概述](/zh-CN/build/core-features/common/game-save/xgamesavefiles.md)
- [概述](/zh-CN/build/console-features/audio/overviews/index.md)
- [DirectStorage 概述](/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md)