O MSIXVC2 está em disponibilidade geral a partir do Microsoft Game Development Kit (GDK) de outubro de 2026. Você pode fazer sideload de pacotes MSIXVC2 para testes e enviá-los para certificação para lançamento público.
Alguns recursos e melhorias do MSIXVC2 chegam por meio de atualizações do Gaming Runtime Services e não exigem uma atualização do GDK. Você recebe automaticamente esses aprimoramentos à medida que são disponibilizados.
Se você estiver empacotando para consoles XBOX, consulte Introdução ao empacotamento para consoles XBOX. Os jogos de console continuam usando XVC. A ferramenta
makepkg lida com ambos os formatos.Antes de começar
- Windows 10 versão 18362 ou posterior no seu PC de desenvolvimento.
- GDK de outubro de 2026 ou posterior instalado. O GDK inclui
makepkg.exe.
A partir do GDK de outubro de 2026, a ferramenta de empacotamento gerenciada se chama
makepkg.exe. O MakePkg.exe herdado e o nome temporário makepkg2.exe foram removidos.- Produto no Partner Center Você precisa da sua identidade de editor, do nome do pacote e da Store ID.
- Modo de desenvolvedor habilitado no seu PC de teste de destino.
- Chave de Registro do modo de desenvolvedor do MSIXVC2 definida em qualquer dispositivo em que você instale ou execute pacotes MSIXVC2. Consulte a Etapa 7 para obter detalhes.
Etapa 1: Preparar seu conteúdo
Coloque todo o material de origem do seu título em um único diretório. Remova todos os arquivos que o sistema de empacotamento não pode usar ou que não são adequados para envio em pacotes de varejo. Remova os seguintes arquivos, se estiverem presentes:- Arquivos PDB.
- Quaisquer referências a outras lojas de jogos para PC, como ativos, binários e muito mais.
- Arquivos de “footprint” da Plataforma Universal do Windows (UWP) e do Appx, incluindo AppxSignature.p7x e AppxBlockMap.xml.
Etapa 2: Criar seu MicrosoftGame.config
Crie um arquivo MicrosoftGame.config no diretório raiz do conteúdo do seu jogo. Esse arquivo de configuração funciona com o MSIXVC. Seu MicrosoftGame.config existente funciona sem alterações com o MSIXVC2. Você pode criar esse arquivo manualmente ou usando o Editor do MicrosoftGame.config, que sincroniza os valores de identidade e de ID diretamente do seu projeto no Partner Center. Para ver um exemplo de arquivo MicrosoftGame.config, consulte Introdução ao MSIXVC para PC.Etapa 3: Identificar dependências de runtime do Visual C/C++
Verifique se o seu MicrosoftGame.config lista todas as dependências de runtime do Visual C/C++ ou se você copia explicitamente essas dependências para o conteúdo do seu pacote. Para obter mais informações, consulte Dependências de pacotes de estrutura.Etapa 4: Criar seus ícones
Coloque os arquivos de ícone na pasta raiz do conteúdo do seu jogo (ou em um subdiretório), dimensionados para os tamanhos especificados na seçãoShellVisuals do seu MicrosoftGame.config. O Editor do MicrosoftGame.config pode gerar essas imagens a partir de uma única imagem de origem.
Etapa 5: Gerar um arquivo de mapeamento de layout (opcional)
Esta etapa é opcional. Por padrão, o MSIXVC2 empacota todo o conteúdo em um único bloco. Você só precisa de um arquivo de mapeamento de layout se quiser dividir o conteúdo em vários blocos ou adicionar marcas do Intelligent Delivery. Para gerar um arquivo de mapeamento de layout, abra um prompt de comando do GDK e execute o seguinte comando:Etapa 6: Criar seu pacote MSIXVC2
Crie o pacote:Etapa 7: Testar seu pacote localmente
Habilite o modo de desenvolvedor no seu PC de destino. Antes de instalar um pacote MSIXVC2, defina a seguinte chave de Registro no dispositivo de destino:packageutil:
O comando
packageutil set requer o GDK de outubro de 2026 ou posterior.Essa chave de Registro é necessária até uma versão futura do GDK. Sem ela, os pacotes MSIXVC2 não serão instalados. Execute o comando em um prompt de comando com privilégios elevados (administrador).
[drive]:\XboxGames. Os arquivos são instalados em sua forma original e você pode acessá-los diretamente. Esse local de instalação é o mesmo usado pelos pacotes MSIXVC com Flat File Install.
Você pode carregar no Partner Center o mesmo pacote do qual faz sideload localmente; não há uma etapa separada de pacote de envio.
Etapa 8: Carregar no Partner Center
Publique pacotes MSIXVC2 em uma nova ramificação no Partner Center (por exemplo,
msixvc2). Não carregue pacotes MSIXVC2 na mesma ramificação dos seus pacotes MSIXVC existentes. Os dois formatos não são intercambiáveis dentro de uma ramificação, e reverter uma ramificação do MSIXVC2 de volta para o MSIXVC exige um carregamento e um download completos do pacote. Para obter mais informações, consulte Práticas recomendadas para ramificações de pacotes.Opção A: Carregar um pacote pré-criado
Se você já criou um pacote na Etapa 6, carregue-o diretamente:Opção B: Carregar a partir de arquivos soltos (fluxo de trabalho de um único comando)
Você pode combinar o empacotamento e o carregamento em um único comando. Esse comando carrega diretamente a partir da saída do build sem criar um arquivo de pacote local:Opções de carregamento
Para ver a lista completa de opções de carregamento, consulte Criar pacote (makepkg.exe).
Métodos de autenticação
O comandoupload dá suporte a vários métodos de autenticação para diferentes ambientes.
Exemplo: carregamento por pipeline de CI/CD