> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 Game Development Kit (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 封裝概觀](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)。

## Flat File Install 對 PC 遊戲開發人員工作流程的變更

Flat File Install 在幾個關鍵方面變更了您使用 MSIXVC 套件的方式，如下所示：

* 套件現在預設會安裝到作業系統根目錄中的 XboxGames 資料夾 (也就是 C:\XboxGames)。除了 `wdapp` install 的 /drive 旗標之外，也可以使用 [wdapp gamefolder](https://docs.xbox.com/zh-TW/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_gamefolder) 命令列工具來設定。此外，C:\XboxGames 資料夾**不需要提升權限即可存取其中的遊戲資料夾和檔案**。
* **除了可執行檔之外，所有檔案預設都可以修改**。這也**降低了執行階段的解密成本**，有益於遊戲效能。如需詳細資訊，請參閱 [PC GDK 遊戲的模組支援](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/packaging-mods.md)。
* 從 MSIXVC 安裝的檔案更接近一般檔案配置，所有檔案都可直接存取。這表示不再有任何套件虛擬化的概念會妨礙寫入遊戲根目錄，或需要停用檔案系統寫入/登錄寫入虛擬化。
* 由於現在可以直接存取和修改檔案，因此下列元素不再需要在 [MicrosoftGame.config](https://docs.xbox.com/zh-TW/reference/system/microsoftgameconfig/microsoftgameconfig-schema.md) 中指定，並且已被取代。
  * ModFolder
  * EnableWritesToPackageRoot
  * DisableFilesystemWriteVirtualization
  * DisableRegistryWriteVirtualization

> [!NOTE]
>
> 如果這些元素存在於已更新為 `Game configVersion="1"` 的 MicrosoftGame.config 中，嘗試封裝您的遊戲時會出現錯誤。錯誤會輸出 "The DesktopRegistration entries "modFolder", "enableWritesToPackageRoot", "disableRegistryWriteVirtualization" and "disableFilesystemWriteVirtualization" are deprecated in configVersion >= 1"。從 MicrosoftGame.config 中移除這些元素即可解決此問題。如需 `Game configVersion="1"` 的詳細資訊以及它是否會影響您的遊戲，請參閱 [MicrosoftGame.config 版本詳細資料](https://docs.xbox.com/zh-TW/reference/system/microsoftgameconfig/microsoftgameconfig-schema.md#MicrosoftGameConfig-VersionDetails)。

## Flat File Install 為 PC 玩家帶來的好處

Flat File Install 可讓玩家透過 XBOX 應用程式選取遊戲的安裝目錄 (每個磁碟機限一個資料夾)、對已安裝的遊戲套用模組、透過 XBOX 應用程式在磁碟機之間移動遊戲，以及透過 XBOX 應用程式修復遊戲。這些變更表示玩家將擁有所有遊戲檔案的讀取和寫入權限，但 MicrosoftGame.config 中指定的可執行檔除外，這些檔案仍會保持加密。這些變更讓更多遊戲可以套用模組，並讓遊戲檔案更容易尋找和管理，回應了 PC 玩家長久以來的要求。

## 備註

* Flat File Install 僅適用於 PC GDK 遊戲。在 Microsoft Store 上以其他應用程式模型 (也就是 UWP) 發行的遊戲不會享有這些好處。
* 如果您有任何自動化作業依賴剖析 MSIXVC 安裝的 C:\Program Files\WindowsApps 路徑，此變更將會影響這些作業，因為除非使用 `wdapp` gamefolder 另行指定，否則所有路徑現在都會指向 C:\XboxGames。
* Flat File Install 將套用至目前已正式發行的大多數遊戲。未來對先前發行之 GDK 的 GDK 更新，將透過 2022 年 3 月 GDK 中的 `wdapp` 工具改進，讓您能更直接地控制此功能。

## 另請參閱

[MSIXVC2 封裝概觀](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)
[開始使用 PC 封裝](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)
[使用 Microsoft Game Development Kit 工具安裝及啟動您的 PC 遊戲](https://docs.xbox.com/zh-TW/tools/tools-pc/launching-on-pc.md)
[MicrosoftGame.config](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-toc.md)


## Related topics

- [開始使用適用於 PC 的 MSIXVC2 封裝](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2.md)
- [開始封裝 PC 遊戲](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)
- [XGameSaveFiles API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/xgamesavefiles.md)
- [概觀](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/overviews/index.md)
- [Game Saves 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/game-saves-overview.md)