Obter as informações de identidade do 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 fez isso, registre-se no programa ID@XBOX e crie uma conta do Partner Center.
- Crie uma definição inicial de produto para seu jogo no Partner Center.
- Na página Game Setup | Identity do seu produto, encontre os valores de identidade listados acima.
Criar o arquivo MicrosoftGame.config na pasta raiz junto com o restante do conteúdo do jogo
Um arquivo XML MicrosoftGame.config de exemplo está incluído mais adiante neste artigo. Use esse exemplo como referência junto com o Editor do MicrosoftGame.config, que pode simplificar a criação do seu arquivo .config e sincronizar automaticamente os valores de ID e nome do seu projeto no Partner Center.Criar os ícones para exibição no shell e nos pacotes da Microsoft Store
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, você pode colocar os ativos de imagem em um subdiretório e ajustar os caminhos dos ícones deShellVisuals de acordo. O Editor do MicrosoftGame.config oferece a capacidade de gerar essas imagens para você a partir de uma única imagem de origem.
Instalar o Microsoft Game Development Kit (GDK) (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 o 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>
Criar o pacote
Como criar o pacote
Siga estas etapas para criar um pacote criptografado com/lk:
- Uma única vez: execute
makepkg genkey /ekb SECRET_KEY.lekbpara criar o arquivoSECRET_KEY.lekb. Esse arquivo é o Local Escrowed Key Blob (LEKB), que armazena a chave de conteúdo estável que criptografa seu pacote. Guarde-o em um local seguro, com acesso restrito a quem precisa dele. Em uma configuração ideal, somente as máquinas e contas oficiais de build devem ter acesso a ele. - Criação do pacote: execute
makepkg pack /lk SECRET_KEY.lekb /f layout.xml /d <Your_Game_Folder_Name> /pd <Output_Folder_Name>. Esse comando cria um pacote criptografado usando a chave armazenada no arquivo SECRET_KEY.lekb.
Observações importantes sobre a criptografia de pacotes
A opção/lk do makepkg criptografa o pacote usando uma chave estável (sempre a mesma) que o comando makepkg genkey cria. Além do pacote do seu título, o makepkg /lk gera arquivos nomeados no formato PackageFullName_licenseName_GUID.EKB e PackageFullName_licenseName_GUID.CEKB. (Observe o uso do caractere de sublinhado (_).)
Use a criptografia /lk para testes em kits de desenvolvimento e para envio no console. Ela oferece estes benefícios em comparação com a criptografia de teste (/lt) e a criptografia de envio (/l):
- O
packageutil comparepode gerar estimativas corretas do tamanho da atualização (ao contrário de/l). - Ela permite o upload delta seguro para o Partner Center usando o mesmo algoritmo que os consoles e PCs usam para baixar atualizações de conteúdo.
- Você pode instalá-lo em devkits (ao contrário de
/l). - Ela usa material de chave de criptografia seguro, e você só pode descriptografá-lo em ambientes específicos (ao contrário de
/lt).
Testar a instalação do pacote
Use o seguinte comando para testar a instalação do pacote:xbapp install <Your_Package>
Se o seu pacote usa recursos do Intelligent Delivery, use a opção /i para invocar a interface do usuário interativa do shell e escolher quais recursos do pacote instalar, para testar a experiência do usuário final no varejo.
xbapp install /i <Your_Package>
Observações importantes sobre a instalação de pacotes
Oxbapp install instala automaticamente o arquivo CEKB necessário para carregar o pacote em um devkit XBOX. Se você estiver testando um cenário de instalação diferente da instalação baseada em ferramentas (disco de jogo, armazenamento externo, transferência de console para console), o comando xbapp installkey pode ser usado para instalar somente o arquivo CEKB. Consulte xbapp.exe para obter mais detalhes.
Arquivos LEKB gerados antes do GDK de abril de 2021 não criam um arquivo CEKB. Para usar o novo recurso de sideload em devkits, o arquivo LEKB deve ser recriado com as ferramentas do GDK de abril de 2021 ou posterior.
Se você planeja criar discos para o seu pacote, consulte os artigos a seguir
Criando discos de compilação de teste Criando discos de teste entre geraçõesEnviar o pacote ao Microsoft Partner Center
O pacote que você criou usando o comando makepkg.exe anterior pode ser usado tanto para testes quanto para envio, pois o sinalizador/lk foi usado para criptografar o pacote. Você também se beneficiará do upload delta ao carregar esse pacote. Os arquivos XVC e EKB são carregados no Partner Center normalmente. Os arquivos LEKB e CEKB não serão carregados.
