> ## 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 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 封裝概觀](/zh-TW/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](/zh-TW/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_gamefolder) 命令列工具來設定。此外，C:\XboxGames 資料夾**不需要提升權限即可存取其中的遊戲資料夾和檔案**。
* **除了可執行檔之外，所有檔案預設都可以修改**。這也**降低了執行階段的解密成本**，有益於遊戲效能。如需詳細資訊，請參閱 [PC GDK 遊戲的模組支援](/zh-TW/build/core-features/common/packaging/packaging-mods)。
* 從 MSIXVC 安裝的檔案更接近一般檔案配置，所有檔案都可直接存取。這表示不再有任何套件虛擬化的概念會妨礙寫入遊戲根目錄，或需要停用檔案系統寫入/登錄寫入虛擬化。
* 由於現在可以直接存取和修改檔案，因此下列元素不再需要在 [MicrosoftGame.config](/zh-TW/reference/system/microsoftgameconfig/microsoftgameconfig-schema) 中指定，並且已被取代。
  * 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 版本詳細資料](/zh-TW/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 遊戲。在 Microsoft Store 上以其他應用程式模型 (也就是 UWP) 發行的遊戲不會享有這些好處。
* 如果您有任何自動化作業依賴剖析 MSIXVC 安裝的 C:\Program Files\WindowsApps 路徑，此變更將會影響這些作業，因為除非使用 `wdapp` gamefolder 另行指定，否則所有路徑現在都會指向 C:\XboxGames。
* Flat File Install 將套用至目前已正式發行的大多數遊戲。未來對先前發行之 GDK 的 GDK 更新，將透過 2022 年 3 月 GDK 中的 `wdapp` 工具改進，讓您能更直接地控制此功能。

## 另請參閱

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


## Related topics

- [Flat File Install overview](/build/core-features/common/packaging/packaging-flatfileinstall.md)
- [Flat File Install 개요](/ko/build/core-features/common/packaging/packaging-flatfileinstall.md)
- [Flat File Install 概述](/zh-CN/build/core-features/common/packaging/packaging-flatfileinstall.md)
- [Flat File Install の概要](/ja-jp/build/core-features/common/packaging/packaging-flatfileinstall.md)
- [Información general de Flat File Install](/es/build/core-features/common/packaging/packaging-flatfileinstall.md)