Skip to main content
Flat File Install 是一項 PC Microsoft Game Development Kit (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
如果這些元素存在於已更新為 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 版本詳細資料。

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 封裝概觀 開始使用 PC 封裝 使用 Microsoft Game Development Kit 工具安裝及啟動您的 PC 遊戲 MicrosoftGame.config
Last modified on October 6, 2026