> ## 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 empacotamento MSIXVC2

> O MSIXVC2 é o novo formato de empacotamento para PC no GDK, oferecendo pacotes base menores, atualizações de conteúdo mais rápidas e um fluxo de trabalho de upload simplificado.

O MSIXVC2 é o novo formato de empacotamento para jogos de PC criados com o Microsoft Game Development Kit (GDK). Ele oferece pacotes de jogo base e atualizações de conteúdo significativamente menores, empacotamento mais rápido e um fluxo de trabalho de upload simplificado em comparação com o formato MSIXVC original. O MSIXVC2 está disponível de forma geral a partir do GDK de outubro de 2026.

<Info>
  O MSIXVC2 é **somente para PC**. Os jogos de console XBOX continuam usando o formato de empacotamento XVC existente. A ferramenta `makepkg` lida com os dois formatos - uma ferramenta para ambas as plataformas.
</Info>

## Por que o MSIXVC2

O formato de empacotamento MSIXVC original foi projetado para um mundo de atualizações pouco frequentes e distribuição baseada em discos. O desenvolvimento de jogos moderno é diferente: os jogos ultrapassam 100 GB, as atualizações são lançadas semanal ou diariamente, e os jogadores esperam atualizações pequenas, rápidas e frequentes.

O MSIXVC2 reduz o atrito de desenvolvimento relacionado ao empacotamento, aos tempos de upload e à eficiência das atualizações de conteúdo, mudando a forma como o conteúdo do jogo é segmentado, desduplicado e entregue.

## Principais melhorias

### Atualizações de conteúdo menores

O MSIXVC2 elimina o preenchimento de alinhamento e as restrições de limite de chunk que hoje aumentam o tamanho das atualizações de conteúdo. As alterações são rastreadas no nível de byte, em vez de em limites fixos de blocos de 4 KB. Mover um arquivo entre chunks ou reordenar o conteúdo dentro de um chunk não dispara um novo download - somente o conteúdo realmente alterado é entregue.

Em testes com títulos já lançados, alguns tamanhos de atualização foram reduzidos de 64% a 94% em comparação com o MSIXVC.

### Empacotamento mais rápido

O `makepkg pack` com `/msixvc2` é executado de forma significativamente mais rápida do que o `MakePkg pack` herdado para títulos grandes. A sobrecarga de empacotamento, que antes representava minutos do tempo de build, é praticamente eliminada.

| Título | MakePkg pack | makepkg pack | Aceleração |
| - | - | - | - |
| Título pequeno (\~1 GB) | 5 s | 2 s | 2,2x |
| Título médio (\~12 GB) | 70 s | 12 s | 5,7x |
| Título grande (\~130 GB) | 14 min | 3 min | 4,6x |
| Título muito grande (\~320 GB) | 52 min | 7 min | 7,6x |

### Sobrecarga de pacote reduzida

Todo pacote MSIXVC hoje inclui uma árvore de hash mínima fixa que cresce com o tamanho do jogo. Para um título de 320 GB, essa sobrecarga é de aproximadamente 2 GB e é sempre baixada por completo a cada atualização. O MSIXVC2 reduz essa sobrecarga em mais de 90% e permite que ela seja baixada parcialmente.

### Compactação integrada

Os ativos que ainda não estão compactados são compactados de forma transparente para transporte e armazenamento na CDN. Na máquina do jogador, os arquivos são instalados descompactados.

### Criptografia por versão

Cada versão de um pacote é criptografada com seu próprio conjunto de chaves, isolando as versões do pacote umas das outras. A criptografia é aplicada na CDN e em trânsito. No dispositivo do jogador, os arquivos instalados são armazenados sem criptografia.

### Upload com um único comando a partir de arquivos soltos

Com o MSIXVC2, você pode combinar empacotamento e upload em uma única etapa:

```text theme={null}
makepkg upload /d <your_build_folder> /msixvc2
```

O fluxo de trabalho tradicional em duas etapas (empacotar localmente e depois carregar separadamente) ainda é compatível para equipes que desejam inspecionar o pacote antes de carregá-lo.

## Diferenças de formato

| Aspecto | MSIXVC | MSIXVC2 |
| - | - | - |
| Segmentação | Blocos de tamanho fixo alinhados em 4 KB | Segmentos de tamanho variável baseados em conteúdo |
| Criptografia | Chave compartilhada entre versões | Chaves por versão |
| Sobrecarga do pacote | Árvore de hash mínima fixa baseada no tamanho do jogo | Sobrecarga mínima |
| Impacto do layout de chunks | Reordenar chunks ou mover arquivos dispara novo download | Alterações no layout de chunks afetam apenas metadados - sem novo download dos ativos movidos |

## O que permanece igual

* **Seu jogo não percebe a diferença.** Os arquivos são instalados em sua forma original. Seu mecanismo os lê da mesma forma que lê arquivos de um diretório de build não empacotado—leituras Win32 e DirectStorage funcionam sem alterações.
* **Seus scripts não quebram.** Os comandos existentes do MakePkg funcionam sem alterações no `makepkg`. O sinalizador `/msixvc2` habilita o novo formato.

<Note>
  O GDK de outubro de 2026 remove o MakePkg.exe herdado e o nome temporário `makepkg2.exe`. O substituto gerenciado é o `makepkg.exe`.
</Note>

* **O Intelligent Delivery funciona da mesma forma.** Você define chunks da mesma maneira. A diferença está nos bastidores - reordenar chunks não tem custo.
* **O fluxo de envio do Partner Center não muda.** As mesmas APIs e a mesma interface para upload e publicação.
* **Os builds de console não são afetados.** O XVC continua funcionando para consoles XBOX. O `makepkg` lida com os dois formatos.

## Escopo e cronograma

| Marco | Detalhes |
| - | - |
| **GDK de abril de 2026** (2604) | Versão prévia pública - habilite com o sinalizador `/msixvc2` |
| **GDK de outubro de 2026** (2610) | Disponibilidade geral |
| **GDK de abril de 2027** (2704) | O MSIXVC2 se torna o formato de pacote padrão para PC |

## Práticas recomendadas para branches de pacote

O MSIXVC2 usa um formato interno diferente do MSIXVC. Os dois formatos não são intercambiáveis no mesmo branch de pacote no Partner Center. Siga estas diretrizes ao adotar o MSIXVC2.

### Usar um branch ou conjunto de pacotes separado

Publique seus pacotes MSIXVC2 em um **novo branch** no Partner Center. Não substitua seus pacotes MSIXVC de produção por builds MSIXVC2. Manter o MSIXVC2 em seu próprio branch permite avaliar o formato lado a lado com seu pipeline MSIXVC existente sem interromper seu jogo publicado nem seu histórico de atualizações de conteúdo existente.

### Fazer downgrade do MSIXVC2 para o MSIXVC

Reverter um branch do MSIXVC2 para o MSIXVC **não é um fluxo de trabalho com suporte**. Como os dois formatos segmentam o conteúdo de forma diferente, voltar um branch para o MSIXVC força uma reingestão completa de todo o conteúdo - na prática, um novo upload completo e um novo download completo para todos os jogadores nesse branch. Planeje-se adequadamente: trate os branches MSIXVC2 como somente de avanço.

### Fluxo de trabalho de migração recomendado

1. **Mantenha seu pipeline MSIXVC existente em execução** para os lançamentos de produção.
2. **Crie um novo branch no Partner Center** (por exemplo, `msixvc2`) para testes de MSIXVC2.
3. **Publique pacotes MSIXVC2 em uma sandbox de desenvolvimento** usando o novo branch. Valide instalações, atualizações e o comportamento do Intelligent Delivery.
4. **Compare os tamanhos das atualizações de conteúdo** entre seus branches MSIXVC e MSIXVC2 para quantificar a melhoria para o seu título. Consulte [Avaliando o MSIXVC2 para seu título](/pt-BR/build/core-features/common/packaging/packaging-updates-msixvc2#evaluating-msixvc2-for-your-title).
5. **Envie o pacote MSIXVC2 para certificação** quando estiver pronto para publicá-lo.

## Considerações sobre preenchimento e alinhamento

Com o MSIXVC, a eficiência das atualizações de conteúdo depende de um alinhamento cuidadoso de 4 KB dos ativos dentro dos arquivos de pacote. Com o MSIXVC2, esses requisitos de alinhamento são eliminados. A segmentação baseada em conteúdo identifica automaticamente os dados inalterados, independentemente do alinhamento ou do layout.

Se o seu título for lançado tanto para PC quanto para console, você pode usar configurações de preenchimento separadas. No MSIXVC2, você pode reduzir ou remover com segurança o preenchimento do seu build de PC. Se preferir manter a mesma configuração entre plataformas, isso também funciona - o MSIXVC2 lida com os dois casos sem penalidade.

## Introdução

Para começar a usar o MSIXVC2, consulte [Introdução ao MSIXVC2 para PC](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2).

Para a referência de linha de comando do `makepkg`, consulte [Make package (makepkg.exe)](/pt-BR/build/core-features/common/packaging/deployment/makepkg).

## Tópicos relacionados

[Visão geral do empacotamento](/pt-BR/build/core-features/common/packaging/overviews/packaging) [Introdução ao MSIXVC2 para PC](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2) [Introdução ao MSIXVC para PC](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) [Atualizações de conteúdo com MSIXVC2](/pt-BR/build/core-features/common/packaging/packaging-updates-msixvc2) [Modelo de criptografia do MSIXVC2](/pt-BR/build/core-features/common/packaging/packaging-encryption-msixvc2) [Make package (makepkg.exe)](/pt-BR/build/core-features/common/packaging/deployment/makepkg) [XBOX Game Package Manager](/pt-BR/build/core-features/common/packaging/xgpm) [Automatizando o upload de pacotes](/pt-BR/build/core-features/common/packaging/package-uploader)


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