> ## 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 は、2022 年 3 月の GDK および [Gaming Runtime Services (GRTS)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/intro/gaming-runtime-glossary) リリースで出荷された PC 用 Microsoft Game Development Kit (GDK) のインストール機能で、インストール後の 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 パッケージの取り扱い方法をいくつかの重要な点で変更します。以下のとおりです。

* パッケージは既定で OS ルート内の XboxGames フォルダー (つまり C:\XboxGames) にインストールされるようになりました。これは、[wdapp gamefolder](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_gamefolder) コマンドライン ツール、または `wdapp` install の /drive フラグを使用して構成できます。加えて、C:\XboxGames フォルダー **は、その中のゲーム フォルダーやファイルにアクセスするために昇格された権限を必要としません**。
* **実行可能ファイルを除き、すべてのファイルは既定で変更可能です**。これにより **ランタイムの復号コストも削減され**、タイトルのパフォーマンスに恩恵をもたらします。詳細については、[PC GDK タイトルの Mod サポート](/build/core-features/common/packaging/packaging-mods) を参照してください。
* MSIXVC からインストールされるファイルはフラット ファイルのレイアウトにより近い形になり、すべてのファイルに直接アクセスできます。これにより、ゲーム ルートへの書き込みを阻害したり、ファイル システムの書き込み/レジストリの書き込みの仮想化を無効にする必要があるパッケージ仮想化の概念はなくなります。
* ファイルに直接アクセスして変更できるようになったため、以下の要素は [MicrosoftGame.config](/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 バージョンの詳細](/reference/system/microsoftgameconfig/microsoftgameconfig-schema#MicrosoftGameConfig-VersionDetails) を参照してください。</Note>

## PC ゲーマーにとっての Flat File Install の利点

Flat File Install により、ゲーマーは XBOX アプリを介してゲームがインストールされるディレクトリを選択できます (1 ドライブあたり 1 フォルダーに制限)、インストール済みのゲームを Mod できる、XBOX アプリでドライブ間でゲームを移動できる、XBOX アプリでゲームを修復できるようになります。これらの変更により、ゲーマーはすべてのゲーム ファイルに対して読み取りと書き込みのアクセス権を持つことになります (MicrosoftGame.config で指定された実行可能ファイルは暗号化されたままです)。これらの変更は、より多くのゲームを Mod 可能にし、ゲーム ファイルの検索と管理を容易にすることで、PC ゲーマーから長らく寄せられていた要望に応えるものです。

## 備考

* Flat File Install は PC GDK ゲームにのみ適用されます。他のアプリ モデル (つまり UWP) で Microsoft Store に出荷されたゲームは、これらの利点を受けられません。
* MSIXVC のインストールについて C:\Program Files\WindowsApps のパスを解析することに依存する自動化がある場合、この変更は影響を与えます。すべてのパスは、`wdapp` gamefolder で別途指定しない限り C:\XboxGames を指すようになります。
* Flat File Install は、現在 GA になっているほとんどのタイトルに適用されます。以前にリリースされた GDK に対する将来の 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 Game Development Kit ツールを利用した PC タイトルのインストールと起動](/tools/tools-pc/launching-on-pc)
[MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc)


## Related topics

- [MSIXVC2 暗号化モデル](/ja-jp/build/core-features/common/packaging/packaging-encryption-msixvc2.md)
- [XGameSaveFiles API の概要](/ja-jp/build/core-features/common/game-save/xgamesavefiles.md)
- [Game Saves の概要](/ja-jp/build/core-features/common/game-save/game-saves-overview.md)
- [XBOX 認定の概要](/ja-jp/publishing/certification/overview.md)
- [DirectStorage の概要](/ja-jp/build/console-features/storage/directstorage/directstorage-overview.md)