Skip to main content
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), 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.
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.

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, 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.
  • 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 e foram preteridos.
    • ModFolder
    • EnableWritesToPackageRoot
    • DisableFilesystemWriteVirtualization
    • DisableRegistryWriteVirtualization
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.

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 Introdução ao empacotamento para PC Utilizando as ferramentas do Microsoft Game Development Kit para instalar e iniciar seu título para PC MicrosoftGame.config
Last modified on October 6, 2026