> ## 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` 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>`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 앱에서 게임이 설치되는 디렉터리를 선택하고(드라이브당 하나의 폴더로 제한), 설치된 게임을 모드하고, 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은 오늘날 정식 출시된 대부분의 타이틀에 적용됩니다. 이전에 릴리스된 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 암호화 모델](/ko/build/core-features/common/packaging/packaging-encryption-msixvc2.md)
- [PC용 MSIXVC2 패키징 시작하기](/ko/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2.md)
- [MSIXVC 도구로 PC 타이틀 패키징 시작하기](/ko/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)
- [MicrosoftGame.config 요소 - DisableFilesystemWriteVirtualization(사용 중단됨)](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-disablefilesystemwritevirtualization.md)
- [MicrosoftGame.config Element - ModFolder (DEPRECATED)](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-modfolder.md)