Pular para o conteúdo principal
Este documento descreve o processo de obtenção de um Microsoft Game Development Kit (GDK) extraído para ser usado sem instalação. Esta seção fornece instruções sobre como fazer isso para o GDK e para o SDK do Windows. Esse processo se destina a usuários avançados.
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:
  1. Extrair cabeçalhos e bibliotecas para uso no seu processo de compilação.
  2. 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.
É possível executar algumas das ferramentas do Microsoft Game Development Kit (GDK) após extrair o conteúdo de instalação dessa forma; no entanto, isso não tem suporte oficial e você pode encontrar problemas.

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.
Usar essa opção de download permitirá que você ignore o processo de extração manual do Microsoft Game Development Kit. Essa é a opção recomendada.

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.
Os procedimentos a seguir mostram um uso específico do Windows Installer (msiexec.exe). Para obter mais informações sobre o msiexec.exe, confira Windows Installer.

Extraindo o conteúdo de todos os MSIs do Microsoft Game Development Kit (GDK) (usando ExtractXboxOneDKs.ps1)

  1. 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.
  2. Extraia o conteúdo do arquivo .zip local.
  3. 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)
  4. Depois de executar o script ExtractXboxOneDKs.ps1, os arquivos extraídos estarão no diretório de destino (como C:\ExtractedGDK\220300)
  5. 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)

  1. 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.
  2. 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.
  3. 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.
  1. 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.
  2. 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).
  3. Percorra a interface do usuário, deixe todas as caixas de seleção marcadas e deixe que ele baixe todos os arquivos.
  4. Navegue até C:\WinSDKDownload para confirmar que os arquivos .msi estão presentes.
    Como alternativa, você pode baixar o .ISO do SDK do Windows e montá-lo. Ele contém os mesmos arquivos .msi produzidos pelas etapas 1 a 4.
  5. 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.
  6. Depois de executar o script ExtractXboxOneDKs.ps1, os arquivos extraídos estarão no diretório de destino (como C:\ExtractedWinSDK)
  7. 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)

  1. 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.
  2. 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.
  3. 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.
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…
Isso permite que o conteúdo completo esteja presente para cada versão. Recomendamos que você use uma variável de ambiente de compilação para alternar entre as versões e definir o que é usado durante o processo de compilação do seu título.

Confira também

Configurando o ambiente de compilação sem instalar o Microsoft Game Development Kit (GDK) Usando o Microsoft Game Development Kit (GDK) sem instalação
Última modificação em 6 de novembro de 2026