> ## 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.

# Visão geral do Flat File Install

> Visão geral do Flat File Install

O Flat File Install é um recurso de instalação do Microsoft Game Development Kit (GDK) para PC, lançado nas versões de março de 2022 do GDK e do [Gaming Runtime Services (GRTS)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/intro/gaming-runtime-glossary), que ajuda a simplificar a forma como os arquivos MSIXVC são organizados no disco após a instalação. O objetivo dessas alterações é reduzir o atrito para os desenvolvedores, tornando a experiência do sistema de arquivos do GDK no PC mais consistente entre os fluxos de trabalho com arquivos soltos e empacotados, e aproximá-la das experiências tradicionais do sistema de arquivos Win32.

<Tip>Os pacotes **MSIXVC2** são instalados nativamente como arquivos simples (flat files), sem necessidade de etapa de extração. O comportamento do Flat File Install descrito nesta página se aplica ao formato MSIXVC original. O MSIXVC2 oferece essa mesma experiência de arquivos simples por padrão. Para obter mais informações, confira [Visão geral do empacotamento MSIXVC2](/pt-BR/build/core-features/common/packaging/overviews/packaging-msixvc2-overview).</Tip>

## Alterações no fluxo de trabalho do desenvolvedor de jogos para PC com o Flat File Install

O Flat File Install altera a forma como você trabalha com pacotes MSIXVC de algumas maneiras importantes. São elas:

* Os pacotes agora são instalados por padrão em uma pasta XboxGames na raiz do sistema operacional (ou seja, C:\XboxGames). Isso pode ser configurado usando as ferramentas de linha de comando [wdapp gamefolder](/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_gamefolder), além do sinalizador /drive da instalação via `wdapp`. Além disso, a pasta C:\XboxGames **não exige permissões elevadas para acessar as pastas e os arquivos de jogos dentro dela**.
* **Todos os arquivos, exceto o executável, são modificáveis por padrão**. Isso também **reduz o custo de descriptografia em runtime**, o que beneficia o desempenho do título. Para obter mais informações, confira [Suporte a mods para títulos GDK para PC](/pt-BR/build/core-features/common/packaging/packaging-mods).
* Os arquivos instalados a partir de um MSIXVC se assemelham mais a um layout de arquivos simples, com todos os arquivos acessíveis diretamente. Isso significa que não há mais nenhuma noção de virtualização de pacote que impeça a gravação na raiz do jogo ou exija a desabilitação da virtualização de gravações no sistema de arquivos/no registro.
* Como os arquivos agora podem ser acessados e modificados diretamente, os seguintes elementos não precisam mais ser especificados no [MicrosoftGame.config](/pt-BR/reference/system/microsoftgameconfig/microsoftgameconfig-schema) e foram preteridos.
  * ModFolder
  * EnableWritesToPackageRoot
  * DisableFilesystemWriteVirtualization
  * DisableRegistryWriteVirtualization

<Note>Se esses elementos estiverem presentes em um MicrosoftGame.config que foi atualizado para `Game configVersion="1"`, um erro será exibido ao tentar empacotar seu título. O erro exibirá "The DesktopRegistration entries "modFolder", "enableWritesToPackageRoot", "disableRegistryWriteVirtualization" and "disableFilesystemWriteVirtualization" are deprecated in configVersion >= 1". Remover esses elementos do MicrosoftGame.config resolverá esse problema. Para obter mais informações sobre `Game configVersion="1"` e se isso afeta seu título, confira [Detalhes da versão do MicrosoftGame.config](/pt-BR/reference/system/microsoftgameconfig/microsoftgameconfig-schema#MicrosoftGameConfig-VersionDetails).</Note>

## Benefícios do Flat File Install para jogadores de PC

O Flat File Install permite que os jogadores selecionem o diretório em que seus jogos são instalados por meio do aplicativo XBOX (limitado a uma pasta por unidade), apliquem mods em jogos instalados, movam jogos entre unidades por meio do aplicativo XBOX e reparem jogos por meio do aplicativo XBOX. Essas alterações significam que os jogadores terão acesso de leitura e gravação a todos os arquivos do jogo, exceto os executáveis designados no MicrosoftGame.config, que permanecerão criptografados. Essas alterações atendem a solicitações antigas dos jogadores de PC, tornando mais jogos compatíveis com mods e facilitando a localização e o gerenciamento dos arquivos do jogo.

## Comentários

* O Flat File Install se aplica somente a jogos GDK para PC. Jogos lançados na Microsoft Store com outros modelos de aplicativo (ou seja, UWP) não terão esses benefícios.
* Se você tiver alguma automação que dependa da análise do caminho C:\Program Files\WindowsApps para instalações MSIXVC, essa alteração a afetará, pois todos os caminhos agora apontarão para C:\XboxGames, a menos que especificado de outra forma com `wdapp` gamefolder.
* O Flat File Install será aplicado à maioria dos títulos que existem em GA atualmente. Futuras atualizações do GDK para GDKs lançados anteriormente permitirão um controle mais direto desse recurso por meio das melhorias nas ferramentas `wdapp` que existem no GDK de março de 2022.

## Confira também

[Visão geral do empacotamento MSIXVC2](/pt-BR/build/core-features/common/packaging/overviews/packaging-msixvc2-overview)
[Introdução ao empacotamento para PC](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC)
[Utilizando as ferramentas do Microsoft Game Development Kit para instalar e iniciar seu título para PC](/pt-BR/tools/tools-pc/launching-on-pc)
[MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc)


## Related topics

- [Visão geral do Unity](/pt-BR/paths/unity/overview.md)
- [Visão geral do Unreal Engine](/pt-BR/paths/unreal/overview.md)
- [Visão geral do XBOX Series X|S](/pt-BR/paths/series-xs/overview.md)
- [Visão geral de portabilidade](/pt-BR/paths/porting/overview.md)
- [Visão geral do Windows & ROG XBOX Ally](/pt-BR/paths/windows/overview.md)