Esse processo não substitui a necessidade de instalar o Microsoft Game Development Kit (GDK) na maioria dos cenários. O processo habilita os seguintes cenários:
- Extrair cabeçalhos e bibliotecas para uso no seu processo de compilação.
- Extrair a pasta Sideload para que o xbprovision (tópico sob NDA) possa ser executado a partir de um determinado Microsoft Game Development Kit (GDK) sem instalar esse Microsoft Game Development Kit (GDK) completo.
Baixando o Microsoft Game Development Kit extraído
O Microsoft Game Development Kit (GDK) extraído, uma opção disponível para usuários avançados, permite que arquivos específicos sejam integrados a um sistema de compilação sem instalar o Microsoft Game Development Kit (GDK) completo. O Microsoft Game Development Kit (GDK) extraído está disponível como uma opção de download separada no site XBOX Developer Downloads. A opção de download é listada com a palavra Extracted no título para diferenciá-la da opção de download do instalador do GDK.Extraindo manualmente o Microsoft Game Development Kit
Como alternativa ao download do Microsoft Game Development Kit (GDK) extraído, você pode extrair manualmente os arquivos do instalador regular do Microsoft Game Development Kit (GDK). Depois de baixar o Microsoft Game Development Kit (GDK) regular, você pode usar o Windows Installer (msiexec.exe) para extrair cada pacote do instalador e acessar seus arquivos individuais.Extraindo o conteúdo de todos os MSIs do Microsoft Game Development Kit (GDK) (usando ExtractXboxOneDKs.ps1)
- Baixe o instalador do Microsoft Game Development Kit no site XBOX Developer Downloads. Ou baixe o instalador público do Microsoft Game Development Kit (GDK) no repositório do GitHub (oferece suporte apenas ao desenvolvimento para PC). O arquivo baixado terá um nome como GDK_03_2022.zip. Anote sua localização no computador.
- Extraia o conteúdo do arquivo .zip local.
- Abra um prompt do PowerShell e navegue até o diretório SetupScripts dentro da pasta para a qual o conteúdo foi extraído (como C:\GDKDownload\SetupScripts)
- O script ExtractXboxOneDKs.ps1 nesse diretório pode ser usado para extrair o GDK. Seu uso é:
.\ExtractXboxOneDKs.ps1 -SourcePath <MSI_Source_Folder> -TargetDirectory <Target_Directory>- Por exemplo, o SourcePath é o local para onde o arquivo .zip foi extraído (como C:\GDKDownload). O TargetDirectory é o local para onde o conteúdo extraído irá (como C:\ExtractedGDK\220300)
- O script ExtractXboxOneDKs.ps1 nesse diretório pode ser usado para extrair o GDK. Seu uso é:
- Depois de executar o script ExtractXboxOneDKs.ps1, os arquivos extraídos estarão no diretório de destino (como C:\ExtractedGDK\220300)
- Navegue até o diretório de destino e copie os arquivos extraídos do GDK para o local exigido pelo seu sistema de compilação.
O diretório de destino inclui um conjunto de arquivos .msi e uma pasta Windows Kits como parte da extração. Eles devem ser ignorados e podem ser excluídos. A pasta Microsoft GDK é a única pasta no diretório de destino da extração que precisa ser mantida.
Extraindo o conteúdo de todos os MSIs do Microsoft Game Development Kit (GDK) (manual)
- Depois de descompactar o GDK (etapas 1 e 2 da seção acima), você pode usar o Windows Installer (msiexec.exe) para extrair cada pacote do instalador e acessar seus arquivos individuais.
-
Em uma janela de prompt de comando, navegue até a pasta com os arquivos extraídos do arquivo .zip e execute a seguinte linha de comando:
em que installation_folder é o caminho para os arquivos baixados do GDK e msi_extraction_path especifica a pasta para a qual você deseja que os arquivos do Windows Installer (.msi) sejam extraídos. Por exemplo:
Se este exemplo de código for usado em um script em vez de diretamente na linha de comando, %G precisará ser substituído por %%G. - Navegue até msi_extraction_path e copie os arquivos extraídos do GDK para o local exigido pelo seu sistema de compilação.
Extraindo o SDK do Windows
A extração manual do conteúdo de instalação do SDK do Windows, uma opção disponível para usuários avançados, permite que arquivos específicos sejam integrados a um sistema de compilação sem instalar o SDK do Windows completo. Essa etapa não é necessária para usar um Microsoft Game Development Kit (GDK) extraído, desde que o SDK do Windows esteja instalado no sistema.Extraindo o conteúdo de todos os MSIs do SDK do Windows (usando ExtractXboxOneDKs.ps1)
A partir do GDK de outubro de 2023, o GDK requer o SDK do Windows 11 (versão 10.0.22000.0) ou posterior.
- Baixe o instalador do SDK do Windows no Windows Dev Center. O arquivo baixado terá um nome como winsdksetup.exe. Anote sua localização no computador.
- Abra um prompt de comando e execute winsdksetup.exe /layout C:\WinSDKDownload no diretório para o qual o exe foi baixado (isso extrairá os arquivos msi do exe).
- Percorra a interface do usuário, deixe todas as caixas de seleção marcadas e deixe que ele baixe todos os arquivos.
- Navegue até C:\WinSDKDownload para confirmar que os arquivos .msi estão presentes.
-
Usando o script mencionado em Extraindo o conteúdo de todos os MSIs do Microsoft Game Development Kit (GDK) (usando ExtractXboxOneDKs.ps1) acima, aponte para a pasta msi (como C:\WinSDKDownload) no SourcePath e para outra pasta (como C:\ExtractedWinSDK) no TargetDirectory, para onde o conteúdo extraído irá.
Devido aos caminhos longos dos arquivos incluídos, é recomendável manter os diretórios de origem e de destino (apenas para a extração) limitados a 45 caracteres (incluindo a letra da unidade). Eles podem ser movidos após a conclusão da extração. Exceder 45 caracteres no caminho da pasta causará falhas na extração devido ao excesso do comprimento máximo do caminho de arquivo.
- Depois de executar o script ExtractXboxOneDKs.ps1, os arquivos extraídos estarão no diretório de destino (como C:\ExtractedWinSDK)
-
Navegue até o diretório de destino e copie os arquivos extraídos do SDK do Windows para o local exigido pelo seu sistema de compilação.
Muitos arquivos/pastas estarão no diretório de destino após essa extração. A pasta Windows Kits\10 é a pasta usada neste exemplo como referência do sistema de compilação. Outras pastas podem ser necessárias, dependendo da ação desejada.
Extraindo o conteúdo de todos os MSIs do SDK do Windows (manual)
- Depois de obter um conjunto de arquivos .msi do winsdksetup.exe (etapas 1 a 4 da seção acima), você pode usar o Windows Installer (msiexec.exe) para extrair cada pacote do instalador e acessar seus arquivos individuais.
-
Em uma janela de prompt de comando, navegue até a pasta com os arquivos extraídos do arquivo .zip e execute a seguinte linha de comando:
em que installation_folder é o caminho para os arquivos baixados do SDK do Windows e msi_extraction_path especifica a pasta para a qual você deseja que os arquivos do Windows Installer (.msi) sejam extraídos. Por exemplo:
Se este exemplo de código for usado em um script em vez de diretamente na linha de comando, %G precisará ser substituído por %%G. - Navegue até msi_extraction_path e copie os arquivos extraídos do SDK do Windows para o local exigido pelo seu sistema de compilação.
Layout recomendado para dar suporte a várias versões extraídas do Microsoft Game Development Kit (GDK)
Ao extrair o Microsoft Game Development Kit, presume-se que essa pasta ficará em um local compartilhado ou em um sistema de controle do código-fonte para ser acessada ao compilar seu título. Pode haver um cenário em que várias versões do Microsoft Game Development Kit (GDK) sejam desejadas. Nesse cenário, nossa recomendação quanto ao layout de várias versões extraídas do Microsoft Game Development Kit (GDK) é a seguinte:- …\ExtractedGDK\211000\Microsoft GDK…
- …\ExtractedGDK\220300\Microsoft GDK…
