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 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.- Se ainda não tiver feito isso, registre-se no programa ID@XBOX e crie uma conta do Partner Center.
- Crie uma definição de produto inicial para o seu jogo no Partner Center.
- 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, 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.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 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 PromptsCriar 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).
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. 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
- Abra Configurações.
- Digite Desenvolvedor no campo de pesquisa. Nas opções exibidas, selecione Usar recursos de desenvolvedor.
- 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). Para obter mais informações sobre os recursos do Flat File Install, consulte Visão geral do Flat File Install.
Preparar seu pacote final e enviá-lo ao Partner Center
O pacote que você criou usando o comando MakePkg.exe 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. Essa ferramenta também facilita a sincronização dos valores de identidade e de ID diretamente do seu projeto no Partner Center.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, 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.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.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.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).
