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

# Introdução ao empacotamento de títulos para PC com as ferramentas MSIXVC

> Introdução ao empacotamento de títulos para PC usando as ferramentas de empacotamento MSIXVC

<Tip>
  **O MSIXVC2 está em disponibilidade geral a partir do GDK de outubro de 2026.** O MSIXVC2 é um formato de empacotamento para PC de última geração que oferece atualizações drasticamente menores, empacotamento mais rápido e um fluxo de trabalho de carregamento simplificado. Se você estiver iniciando um novo título para PC ou avaliando opções de empacotamento, consulte [Visão geral do empacotamento MSIXVC2](/pt-BR/build/core-features/common/packaging/overviews/packaging-msixvc2-overview) e [Introdução ao MSIXVC2 para PC](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2). As etapas desta página se aplicam ao formato MSIXVC original, que continua com suporte total.
</Tip>

Use as etapas a seguir para criar um pacote MSIXVC do qual você pode fazer sideload para testes no seu PC de desenvolvimento de teste de destino e, em seguida, enviar ao Partner Center para publicação.

## Verificar os requisitos mínimos de versão do Windows 10

O Windows 10 versão 18362 ou posterior é necessário para o teste de implantação de pacotes baseados em MSIXVC.

## Avaliar suas necessidades de empacotamento

Se o seu pacote tiver qualquer uma das propriedades a seguir ou precisar de qualquer um dos recursos a seguir, consulte a seção [Outras considerações de empacotamento e recursos avançados](#other-packaging-considerations-and-advanced-features) mais adiante neste artigo.

* **Dependências de pacotes de estrutura** Se o seu aplicativo depende de software redistribuível, você pode usar versões pré-empacotadas da Microsoft de muitos desses pré-requisitos, que você pode declarar como dependências e instalar automaticamente.
* **Ações de instalação personalizadas** Se o seu aplicativo depende de software redistribuível que não tem um pacote de estrutura disponível, você pode instalar essas dependências em cadeia.

## Preparar seu conteúdo

Coloque todo o material de origem do seu título em um único diretório. Remova todos os arquivos aos quais o sistema de empacotamento MSIXVC não dá suporte ou que não são adequados para envio em pacotes de varejo.

* Arquivos de banco de dados de programa (PDB).
* Arquivos de footprint da Plataforma Universal do Windows (UWP) e do APPX, incluindo AppxSignature.p7x e AppxBlockMap.xml. Se você já lançou como UWP na Microsoft Store, talvez tenha alguns desses arquivos associados ao seu pacote APPX ou MSIX. Remova esses arquivos.
* Quaisquer referências a outras lojas de jogos para PC: ativos, binários e muito mais.

## Obter as informações de identidade do seu produto no Partner Center

Seu pacote faz referência à identidade do produto atribuída ao seu jogo no Partner Center, incluindo sua identidade de editor, PackageFamilyName, MSAAppId e TitleId. Configure seu produto e obtenha essas informações na página **Game Setup | Identity** para uso no seu MicrosoftGame.config.

1. Se ainda não tiver feito isso, [registre-se no programa ID@XBOX](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/pc-e2e-guide/e2e-register-id-at-xbox) e [crie uma conta do Partner Center](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/pc-e2e-guide/e2e-creating-partnercenter-account).
2. [Crie uma definição de produto inicial](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/pc-e2e-guide/e2e-creating-partnercenter-product-definition) para o seu jogo no Partner Center.
3. Na página **Game Setup | Identity** do seu produto, localize os valores de identidade listados acima.

## Criar seu arquivo XML MicrosoftGame.config na pasta raiz e, em seguida, criar o restante do conteúdo do jogo

Um exemplo de arquivo xml MicrosoftGame.config está incluído mais adiante neste artigo. Use esse exemplo como referência junto com o [Editor do MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Editor), que simplifica a criação do seu arquivo .config e sincroniza automaticamente os valores de ID e de nome do seu projeto no Partner Center.

## Identificar dependências de runtime do Visual C/C++

Identifique todas as dependências de runtime do Visual C/C++ do seu pacote. Verifique se elas estão listadas como dependências no seu MicrosoftGame.config ou se são copiadas explicitamente para o conteúdo do seu pacote. Para obter mais informações, consulte [Dependências de pacotes de estrutura](/pt-BR/build/core-features/common/packaging/packaging-framework-packages).

## Criar seus ícones para exibição no shell e nos pacotes da loja

Para cada imagem listada no exemplo de MicrosoftGame.config a seguir, coloque um arquivo correspondente na pasta raiz do seu jogo, dimensionado para o tamanho especificado. Como alternativa, coloque os ativos de imagem em um subdiretório e ajuste os caminhos dos ícones de ShellVisuals para corresponder. O [Editor do MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Editor) oferece a capacidade de gerar essas imagens para você usando uma única imagem de origem como entrada.

## Instalar o Microsoft Game Development Kit, que inclui a ferramenta de empacotamento MakePkg.exe

Por padrão, os prompts de comando do Microsoft Game Development Kit (GDK) ficam nesta pasta: C:\Program Files (x86)\Microsoft GDK\Command Prompts

## Criar seu arquivo de mapeamento de layout de empacotamento

Abra um prompt de comando do Microsoft Game Development Kit (GDK) na pasta que contém uma única pasta com todo o conteúdo do seu jogo e execute o seguinte comando:

`MakePkg genmap /f layout.xml /d <Your_game_folder>`

Esse comando cria um arquivo chamado `layout.xml` (esse nome de arquivo é o sugerido, mas você pode usar qualquer outro nome). Use esse arquivo durante a etapa de empacotamento. Para obter mais informações sobre as ferramentas de empacotamento, consulte [Criar pacote (makepkg.exe)](/pt-BR/build/core-features/common/packaging/deployment/makepkg).

## Usar o Intelligent Delivery para determinar como reduzir o tamanho das instalações

Para saber como reduzir o tamanho das instalações marcando conteúdo no seu arquivo layout.xml, consulte [Visão geral do Intelligent Delivery](/pt-BR/build/core-features/common/packaging/overviews/intelligentdelivery). Considere usar o Intelligent Delivery se você tiver ativos localizados volumosos ou conteúdo que não deve ser instalado por padrão, mas que deve estar disponível para download quando acionado pelo seu jogo.

## Criar seu pacote

Crie o pacote usando o seguinte comando:

`MakePkg pack /f layout.xml /lt /d <Your_game_folder_name> /nogameos /pc /pd <Output_Folder_Name>`

Para cenários dependentes de licenciamento, como a loja no jogo e a avaliação, use `makepkg` com a ID de conteúdo real. O Partner Center gera essa ID de conteúdo real na primeira vez que ingere o pacote. Você pode encontrá-la nos detalhes do pacote enviado na página **Packages**.

## Habilitar o modo de desenvolvedor no seu PC de destino

1. Abra **Configurações**.
2. Digite **Desenvolvedor** no campo de pesquisa. Nas opções exibidas, selecione **Usar recursos de desenvolvedor**.
3. Selecione **Modo de desenvolvedor**. Uma caixa de diálogo é exibida informando que o sistema está adicionando alguns recursos. Antes de passar desta etapa, aguarde a conclusão desse processo.

## Testar a instalação do seu aplicativo

Execute o seguinte comando: `Wdapp install <Your_Package.msixvc>`

O pacote deve estar em uma unidade local do seu PC de desenvolvimento ou em um local de rede mapeado para uma letra de unidade. A instalação a partir de compartilhamentos UNC (Convenção de Nomenclatura Universal) ainda não tem suporte. Se você não vir o progresso, poderá abrir o aplicativo Microsoft Store e ver o progresso na seção **Downloads e atualizações**, indicada por uma seta apontando para baixo no canto superior direito do aplicativo, se houver. Você também pode selecionar as reticências (...) e, em seguida, selecionar **Downloads e atualizações**.

A partir do Microsoft Game Development Kit (GDK) de março de 2022, os pacotes MSIXVC são instalados na pasta `[drive]:\XboxGames` organizados como arquivos simples que você pode modificar e acessar diretamente. Você pode configurar o local dessa unidade usando o [Gerenciamento de aplicativos (wdapp.exe)](/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp). Para obter mais informações sobre os recursos do Flat File Install, consulte [Visão geral do Flat File Install](/pt-BR/build/core-features/common/packaging/packaging-flatfileinstall).

## Preparar seu pacote final e enviá-lo ao Partner Center

O pacote que você criou usando o comando [MakePkg.exe](/pt-BR/build/core-features/common/packaging/deployment/makepkg) anterior usou o parâmetro **/LT**, que criptografa usando uma chave de teste ou de desenvolvimento. Para obter o máximo de segurança, execute o comando MakePkg.exe novamente com o sinalizador `/LK` para criptografá-lo usando uma chave estável ou com o sinalizador `/L` para criptografá-lo usando uma chave exclusiva. Use `/LK` em vez de `/L`, porque os pacotes criados com `/LK` podem ser usados para comparações locais de tamanho delta e se beneficiam de otimizações de carregamento delta ao enviar ao Partner Center.

## Exemplo de MicrosoftGame.config

Crie um arquivo chamado MicrosoftGame.config. Use o conteúdo a seguir no diretório raiz do conteúdo do seu jogo e, em seguida, remova os comentários de itens de que você não precisa.

Embora você possa criar o MicrosoftGame.config manualmente, a melhor maneira de criar esse arquivo é usando o [Editor do MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Editor). Essa ferramenta também facilita a sincronização dos valores de identidade e de ID diretamente do seu projeto no Partner Center.

```xml theme={null}
<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <!-- Publisher should match the exact value provided in the "Package/Identity/Publisher" field of the Game setup -> Identity section of your product's configuration area in Partner Center.
         Name should match the exact value provided in the "Package/Identity/Name" field of the Game setup -> Identity section of your product's configuration area in Partner Center. -->
    <Identity Name="**REPLACE**"
        Publisher="**REPLACE**"
        Version="1.0.1.0"/>
        <!-- For MSIXVC/MSIXVC2 the fourth digit of the version number is reserved for Microsoft Store use -->

    <!-- These values are found in the Game Setup -> Identity section in your product's configuration area in Partner Center. -->
    <StoreId>**REPLACE WITH STOREID**</StoreId>
    <MSAAppId>**REPLACE WITH MSAAPPID**</MSAAppId>
    <TitleId>**REPLACE WITH TITLEID**</TitleId>

    <!--  Include any additional languages your title supports as appropriate -->
    <Resources>
      <Resource Language="en-US" />
    </Resources>

     <!-- Use override display name if you want to display a different title in the shell than the DefaultDisplayName from the ShellVisuals section, or if you need to localize it. -->

     <!-- Configuring the Alias attribute will allow you to take advantage of Execution Alias functionality when launching your executable. For more information, please see the MicrosoftGame.config reference documentation. -->

    <ExecutableList>
      <Executable Name="**REPLACE**"
                  Id="Game"
                  Alias="**REPLACE**"
                  OverrideDisplayName="**REPLACE**"
                  />
    </ExecutableList>

    <!-- DefaultDisplayName should match the exact value provided in the "Package/Identity/Name" field of the Game setup -> Identity section of your product's configuration area in Partner Center.
         PublisherDisplayName should use the exact value provided in the "Package/Properties/PublisherDisplayName" field of the Game setup -> Identity section of your product's configuration area in Partner Center.-->
    
    <!-- The following asset sizes apply
         StoreLogo - 100x100
         Square150x150Logo - 150x150
         Square44x44Logo - 44x44
         SplashScreenImage - 1920x1080
    -->
    <ShellVisuals DefaultDisplayName="**REPLACE**" 
                  PublisherDisplayName="**REPLACE**"
                  StoreLogo="StoreLogo.png"
                  Square150x150Logo="Logo.png"
                  Square44x44Logo="SmallLogo.png"
                  Description="**REPLACE**"
                  BackgroundColor="#000040"
                  SplashScreenImage="SplashScreen.png"/>
    
    <DesktopRegistration>
      <!-- Include this section if you need to run a custom installer action with Administrator privileges the first time that your game runs.
           Any executable you specify must be located under the "Installers" folder in the base folder of your game. Don't include any other files in the
           Installers folder.
      <CustomInstallActions>
        <Folder>Installers</Folder>
        <InstallActionList>
          <InstallAction File="CustomInstaller.exe" Name="UniqueInstallTaskName" Arguments="/silent /example" />
        </InstallActionList>
      </CustomInstallActions>
      -->
      <DependencyList>
        <!-- Omit the Dependency items if your game doesn't need them, or the entire DependencyList element. Note that your version of VCLibs may be different. See the Framework package dependencies topic of the documentation for details and guidance. -->
        <KnownDependency Name="VC11"/>
      </DependencyList>
        <!-- Select the ProcessorArchitecture that matches your game executables. -->
      <ProcessorArchitecture>x64</ProcessorArchitecture>
      <!--<ProcessorArchitecture>x86</ProcessorArchitecture>-->

      <!-- Include this section if your game uses Xbox services Multiplayer invites.
      <MultiplayerProtocol>true</MultiplayerProtocol>
      -->
    </DesktopRegistration>

    <!-- Include this section if your game writes files to its installation directory, and you're unable to change this by altering your source code and recompiling your game.
    <ExtendedAttributeList>
      <ExtendedAttribute Name="RestrictedCapability" Value="packageWriteRedirectionCompatibilityShim"/>
    </ExtendedAttributeList>
    -->
</Game>
```

## Outras considerações de empacotamento e recursos avançados

### Pacotes de estrutura para dependências de software comuns

Se o seu aplicativo depende de algum software redistribuível e esse software está disponível na Microsoft Store como um pacote de estrutura, declare uma dependência do pacote de estrutura em vez de instalar o redistribuível em cadeia.

Por exemplo, se o seu aplicativo usa o runtime herdado do DirectX, que historicamente era atendido usando o dxsetup.exe [redistribuído a partir do site de downloads da Microsoft](https://www.microsoft.com/download/details.aspx?id=35), declare uma dependência do pacote de estrutura junto com as dependências padrão de Windows.Universal e Windows.Desktop, da seguinte maneira. Essa abordagem é preferível à instalação direta do redistribuível usando uma ação de instalação personalizada, porque os pacotes de estrutura podem ser atualizados automaticamente pela Microsoft Store, e as ações de instalação personalizadas exigem aprovação do administrador e geram solicitações de confirmação como parte do processo de instalação.

```xml theme={null}
<DependencyList>
  <KnownDependency Name="DX11"/>
</DependencyList>
```

Para ver a lista completa de dependências conhecidas, consulte a documentação de [Elemento do MicrosoftGame.config - KnownDependency](/pt-BR/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-knowndependency).

No momento da instalação, o sistema operacional e a Microsoft Store garantem que essa dependência de pacote seja instalada junto com seu aplicativo. Para obter mais informações, incluindo informações sobre as dependências de pacotes de estrutura do DirectX e do runtime do Visual Studio C/C++, consulte [Dependências de pacotes de estrutura](/pt-BR/build/core-features/common/packaging/packaging-framework-packages).

### Suporte a mods

A partir do Microsoft Game Development Kit (GDK) de março de 2022, há suporte a mods por padrão. Para obter mais informações, consulte [Mods](/pt-BR/build/core-features/common/packaging/packaging-mods).

### Ações de instalação personalizadas

Se o seu aplicativo depende de outros instaladores (arquivos .exe ou .msi) que precisam ser instalados em cadeia quando seu aplicativo é instalado, use o elemento CustomInstallActions para configurar essa etapa.

Para redistribuíveis, verifique se há um pacote de estrutura disponível que contenha os pré-requisitos de que você precisa antes de decidir usar um instalador personalizado para itens como arquivos .exe ou .msi redistribuíveis do runtime do VC ou do DirectX. Para obter instruções detalhadas sobre ações de instalação personalizadas, consulte [Ações de instalação personalizadas](/pt-BR/build/core-features/common/packaging/packaging-custom-install-actions).

### Permissões de funcionalidades restritas

Além de configurar seu arquivo MicrosoftGame.config para incluir os elementos corretos, envie um email ao seu Gerente de Conta para habilitar as permissões necessárias para que seu título use os recursos a seguir.

* Ações de instalação personalizadas (elemento CustomInstallActions).

## Artigos relacionados sobre empacotamento

[Visão geral do empacotamento MSIXVC2](/pt-BR/build/core-features/common/packaging/overviews/packaging-msixvc2-overview) [Introdução ao MSIXVC2 para PC](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2) [Introdução ao empacotamento de títulos para consoles XBOX](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-console) [MicrosoftGame.Config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc) [Usar as ferramentas do Microsoft Game Development Kit para instalar e iniciar seu título para PC](/pt-BR/tools/tools-pc/launching-on-pc) [PC Bootstrapper](/pt-BR/build/gdk-and-engines/guides/pc-bootstrapper)


## Related topics

- [Glossário de termos e siglas do GDK](/pt-BR/home/glossary.md)
- [Documentação de desenvolvimento de jogos XBOX](/pt-BR/index.md)
- [Visão geral de portabilidade](/pt-BR/paths/porting/overview.md)
- [Instale a cadeia de ferramentas do GDK](/pt-BR/home/setup-install/download-install.md)
- [Compile e execute seu primeiro título de console com o GDKX](/pt-BR/home/build-first-title/first-console-title-walkthrough.md)