Pular para o conteúdo principal

Introdução

Bem-vindo ao Microsoft Game Development Kit with XBOX Extensions (GDKX) de abril de 2026 e à versão pública do GDK. Você pode usar o GDKX para desenvolver jogos que podem ser certificados e aprovados para lançamento em PCs com Windows 11, PCs com Windows 10, XBOX One e consoles XBOX Series X|S usando uma base de código compartilhada. Com o GDK, você pode desenvolver jogos que podem ser certificados e aprovados para lançamento em PCs com Windows 11 e PCs com Windows 10.

GDKX

  • O GDKX de abril de 2026 pode ser instalado lado a lado com GDKXs de novembro de 2019 e posteriores.
  • Você pode baixar as versões do GDKX em https://aka.ms/gdkdl.
  • As notas de versão de todas as versões do GDKX estão em https://aka.ms/gdkreleasenotes.

GDK

Sobre este documento

Organizamos este documento nas seções a seguir.
OBSERVAÇÃO: as notas de versão têm um número após suas descrições, como [12345678]. Para usuários do GDKX, esse número representa uma ID interna que a Microsoft usa para acompanhar o trabalho e o histórico relacionados ao item. Esse número pode ser útil para o gerente de conta de desenvolvedor caso você tenha dúvidas sobre uma nota de versão específica.

Novidades do Microsoft Game Development Kit de abril de 2026

  • O GDKX e o GDK são lançados em dois tipos: principais (com foco em recursos, duas vezes por ano) e atualizações (com foco em correções, com a frequência que os parceiros precisarem).
  • Para ver a seção Novidades completa, consulte a versão online de Novidades.
  • Para ver as notas de versão de versões anteriores do GDKX, consulte as publicações de notas de versão nos fóruns do GDK. Para o GDKX e o GDK, você pode ver as notas de versão na documentação online em Notas de versão do GDK.

GDK de abril de 2026 – Atualização 5

Correções de problemas

PlayFab Party

O PlayFab Party foi atualizado para a v1.10.26, que inclui as seguintes correções:
  • Corrigida uma possível falha ao destruir um PartyEndpoint.
  • Corrigido o tratamento de respostas vazias, malformadas ou incompletas de /MultiplayerServer/GetCognitiveServicesToken. Agora o Party relata a solicitação como com falha, em vez de possivelmente falhar.
  • Corrigida uma possível falha caso a configuração de conectividade direta fosse concluída depois que um dispositivo remoto saísse de uma rede ponto a ponto.
[63883777]

Sistema

Corrigida uma possível falha do título em xgameruntime.dll!OnRuntimeDisconnected quando cadeias de caracteres grandes são passadas para XSpeechSynthesizerCreateStreamFromText. [63860960]
Tratamento aprimorado da pressão de memória ao executar operações de leitura ou gravação de salvamentos de jogo. [63996543]
Códigos de erro aprimorados retornados quando uma operação de leitura ou gravação de salvamento de jogo falha. [63996543]

GDK de abril de 2026 – Atualização 4

Correções de problemas

Social Manager

Corrigido um problema em que a DLL GDK C Thunks não exportava as funções de manipulador de alterações da lista de silenciados e da lista de bloqueados de Privacy e da contagem de solicitações de amizade de Social; por isso, os títulos que as chamavam eram vinculados silenciosamente à biblioteca estática da XSAPI em vez da DLL de thunks e acabavam com um runtime incompatível. [63776691]
Corrigida uma falha por estouro de pilha ao preencher o grafo social do Social Manager, porque PeoplehubService::DeserializeUser usava um quadro de pilha de 17 KB contendo três cópias redundantes de cada XblSocialManagerUser. [63776693]

MSIXVC1 (Empacotamento)

makepkg2 pack sem a opção /msixvc2 volta a funcionar sem gerar um erro sobre a opção /usepublisherkey. Esse problema foi introduzido na Atualização 3. [63529609]

Wdapp

Corrigido um problema em que o uso de wdapp register em um jogo com binários ARM64 e x64 não escolhia o binário apropriado em computadores ARM64. [63756866]

PIX

Corrigido um problema na linha do tempo do PIX em que as setas de fences nomeados não eram exibidas. [63446892]

GDK de abril de 2026 – Atualização 3

Notificações

Publisher Content

Os jogos para PC e console agora podem incluir Publisher Content, um novo tipo de pacote que permite que os publicadores de jogos hospedem e atualizem conteúdo em suas próprias CDNs, enquanto a plataforma continua gerenciando a instalação, o download em segundo plano, a integridade e a experiência do usuário. Os desenvolvedores o declaram no MicrosoftGame.config (por meio do novo elemento PublisherContent no jogo base e do campo PublisherContentBaseProduct no pacote de conteúdo) e produzem o pacote com os novos parâmetros correspondentes do makepkg. Os jogos podem identificar o tipo de um pacote retornado pelas APIs existentes do GDK usando a nova API XPackageGetPackageKind(), que agora relata XPackageKind::PublisherContent além de Game e Content. [63082917]

PlayFab Party

O conjunto de ferramentas da plataforma Windows usado para compilar a biblioteca foi atualizado da v142 para a v143. [63294760]

PIX

Uma nova ferramenta de CLI está disponível para converter capturas de tempo programáticas: convertpevt.exe. [62666766]

Correções de problemas

Clang/LLVM

A biblioteca abrangente do XBOX Game OS xgameplatform.lib foi atualizada com as seguintes APIs Win32 para oferecer suporte à implementação de instrumentação PGO do clang/LLVM: FlushViewOfFile, VirtualUnlock. Os desenvolvedores que usam o PGO do clang/LLVM também precisam fornecer aliases de vinculação para algumas APIs POSIX herdadas usadas pela implementação do clang/LLVM para que a vinculação seja bem-sucedida:
[62740693]

PIX

O carregamento de caches grandes de PDBs de sombreadores externos está mais confiável e consistente. [63014983]

PIX DirectStorage

Corrigido um problema que causava um comportamento de zoom incorreto ao navegar a partir do modo de exibição Element Details ou do modo de exibição Range Details em Timing Captures. [62664029]
Corrigido um problema que dificultava a leitura do marcador em forma de losango que indica o início de um lote do DirectStorage na linha do tempo de Timing Capture no modo escuro. [62664035]

XBOX Manager

Corrigida uma falha do XBOX Manager que podia ocorrer ao exibir vídeo de um console ou de um grupo na guia Remote Control. [62844048]

PlayFab Game Saves

Corrigidos pequenos problemas de relatório de telemetria no Steam Deck em que determinados campos de diagnóstico eram preenchidos incorretamente durante operações de salvamento. [62642608]
O recurso de upload do perdedor de conflito foi desabilitado no Steam Deck para corresponder ao comportamento do XBOX/GRTS. [62642612]
Corrigido um problema em que o PlayFab Game Saves tratava incorretamente chaves do Registro ausentes, resultando em um erro de inicialização. [62642607]

Social Manager

Corrigido um problema em que a lista de amigos do Social Manager podia permanecer intermitentemente vazia durante uma sessão inteira (XblSocialManagerDoWork não gerava nenhum evento LocalUserAdded) quando a solicitação inicial da lista de amigos do People Hub nunca era concluída. Agora a solicitação inicial é recuperada automaticamente, de modo que o grafo social é preenchido sem exigir a reinicialização do jogo. [63202269]
Corrigido um problema em que o Social Manager retornava um nome de título e um texto de rich presence incorretos para um amigo jogando um título cujo nome de exibição contém um hífen, porque a cadeia de caracteres de presença era dividida no primeiro hífen, em vez de no separador pretendido de espaço-hífen-espaço. [63202289]

PlayFab Party

Corrigidos os fluxos de voz com manipulação de áudio que não produziam buffers quando o título ainda não tinha configurado uma saída de áudio. [63294702]
Corrigida uma possível perda de voz ao fazer a transição entre redes enquanto a manipulação de áudio está ativa. [63294760]
Corrigida a ausência da transcrição final de fala em texto quando um fluxo de captura com manipulação de áudio está ativo. [63294760]
Corrigida uma possível falha no desligamento quando a fila de tarefas do processo era excluída antes que o Party terminasse de desligar. [63294760]
Corrigido um possível uso após liberação em que objetos internos de acompanhamento HTTP podiam ser excluídos antes da conclusão da tarefa assíncrona subjacente. [63294760]
Corrigido um bug em que o PlayFab Party não conseguia se associar à sua porta multijogador UDP em alguns ambientes de PC com registros WMI configurados incorretamente. [63251323]

Publisher Content

Corrigido um bug interno em XTaskQueue para evitar uma espera infinita durante a desmontagem. [63190218]

MSIXVC2

A criação do MSIXVC2 agora é bem-sucedida mesmo que o layout.xml do Intelligent Delivery tenha vários recursos que usam o mesmo arquivo de imagem. [63117723]
O comando pack do MSIXVC2 ignora normalmente as opções /maxencryptionfragments e /nogameos (que não têm efeito em um MSIXVC2) para facilitar sua inclusão em pipelines de build existentes. [63118134]
O comando pack do MSIXVC2 agora inclui corretamente os arquivos do diretório de origem que são links simbólicos. Antes, ele os tratava incorretamente como arquivos de comprimento 0. [63118309]

GDK de abril de 2026 – Atualização 2

Notificações

Ferramentas de desenvolvedor

O modelo Direct3D 12 Desktop Game (Classic) para o Visual Studio 2019 não tem mais configurações ARM64. O suporte para direcionar ARM64 com o Visual Studio 2019 foi preterido. É necessário o Visual Studio 2022 ou posterior. [62468394]

Arquivos Markdown disponíveis

Um arquivo .zip com os arquivos Markdown da documentação do GDK foi adicionado ao instalador do GDK. Antes, esse arquivo .zip estava disponível apenas como um download separado em https://aka.ms/gdkdl. [62398050]

Correções de problemas

Entrada

Corrigido um problema em que ocorria um possível erro de memória insuficiente ao chamar GameInputCreate na versão NuGet do GameInput no XBOX. [62353092]

PIX

Corrigido um problema em que o PIX relatava incorretamente o modo do console como Lockhart ao abrir capturas feitas no Lockhart 40GB. [62490828]

Mídia

Corrigido um problema que fazia com que a Media Foundation Transform (MFT) do decodificador H.264 parasse de responder durante a destruição quando o decodificador era criado e destruído sem o envio de amostras de vídeo de entrada. [62525251]

Sistema

Corrigido um problema em pacotes MSIXVC2 não assinados (locais) que não eram instalados com o uso de wdapp. [62386086]

GDK de abril de 2026 – Atualização 1

Notificações

XBOX Game Package Manager

Use a versão mais recente da interface do usuário do XBOX Game Package Manager (XGPM) do GitHub ao criar e carregar pacotes MSIXVC2. Essa versão inclui várias correções. Para baixá-la, acesse releases - Microsoft/PackageUploader.

Correções de problemas

Sistema

Corrigido um vazamento de memória na API XGameActivationAcceptPendingInvite. [61953160]
Corrigido um problema em que XLaunchUri falhava com URIs com mais de 21 caracteres. [62181431]
Corrigido um problema nos arquivos de cabeçalho do GDK XGameInvite.h e XGameProtocol.h que podia causar um erro de compilador C4768. [62181564]

MSIXVC2

Corrigidos vários problemas de confiabilidade e desempenho de componentes na versão prévia do MSIXVC2. [62225080]

Ferramentas de desenvolvedor

Corrigido um problema em que o MicrosoftGame.config Editor falhava silenciosamente ao salvar ou criar novos arquivos enquanto relatava êxito. [62226865]

GDK de abril de 2026

Notificações

Preterição do layout do GDK

As versões do GDK de outubro de 2025 e abril de 2026 incluem os layouts simplificado e herdado. A partir do GDK de outubro de 2026, a instalação instala apenas o layout simplificado por padrão. O layout herdado ainda pode ser selecionado como uma instalação opcional, mas foi preterido e não é mais o caminho de desenvolvimento recomendado. O layout herdado não terá mais suporte e será removido do instalador a partir da versão do GDK de abril de 2027.

Preterições de API

A API XGameActivation substituiu as APIs XGameProtocol e XGameInvite, fornecendo uma única superfície de API para todos os cenários de ativação de jogos. Como resultado, XGameProtocol e XGameInvite foram preteridas. As implementações existentes continuarão funcionando, mas recomendamos migrar para XGameActivation em novos desenvolvimentos e para compatibilidade futura. As seguintes APIs foram preteridas.
  • XGameProtocolRegisterForActivation
  • XGameProtocolUnregisterForActivation
  • XGameInviteRegisterForEvent
  • XGameInviteUnregisterForEvent
  • XGameInviteRegisterForPendingEvent
  • XGameInviteUnregisterForPendingEvent
  • XGameInviteAcceptPendingInvite
Para obter mais informações, consulte XGameActivation. [61232139]

Ferramentas de desenvolvedor

O suporte padrão para o Visual Studio 2019 expirou. O suporte estendido continua até abril de 2029. Para obter mais informações sobre o ciclo de vida e a manutenção do produto Visual Studio 2019, consulte Visual Studio 2019 Product Lifecycle and Servicing. O Visual Studio 2019 e o compilador do conjunto de ferramentas v142 estão fora do suporte padrão desde abril de 2024 e recebem apenas manutenção de segurança. O suporte à integração do Visual Studio 2019 e ao uso do conjunto de ferramentas da plataforma v142 por meio do Visual Studio 2022/Visual Studio 2026 será removido em uma versão futura do GDK. Esse processo incluirá a remoção da biblioteca Microsoft.Xbox.Services.142.GDK.C.lib. Para o Visual Studio 2022 e o Visual Studio 2026, recomendamos migrar para Microsoft.Xbox.Services.143.GDK.C.lib, que foi adicionada no GDK de abril de 2026. [61594513]
O Address Sanitizer (ASAN) para XBOX não tem mais suporte no Visual Studio 2019. [60868415]
As capturas de tela agora podem ser copiadas para a área de transferência na guia Media Capture do XBOX Manager. [41667882]
Ferramentas de linha de comando do PC, como wdcapture, wdcapturesession e xblpcsandbox, agora oferecem suporte ao envio direto de comentários sobre bugs por meio do aplicativo Hub de Feedback. [60250549]
O Package Uploader agora oferece suporte a credenciais federadas. [60771527]

Microsoft Azure PlayFab

O PlayFab Multiplayer foi atualizado para a v1.9.0. Para obter detalhes, consulte Notas de versão do PlayFab Multiplayer C++ SDK - PlayFab | Microsoft Learn. [61288995]

Microsoft Azure PlayFab Party

O PlayFab Party foi atualizado para a v1.10.18. Para obter detalhes, consulte Notas de versão do PlayFab Party - PlayFab | Microsoft Learn. [61288995]

Correções de problemas

Corrigido um problema que fazia com que a configuração de idioma em um prompt de comando que não estivesse em inglês mudasse para inglês após a execução de ferramentas de linha de comando do GDK para XBOX, como xbapp.exe ou xbconnect.exe. [59688191]
Corrigido um problema em que o XBOX Game Package Manager não preenchia a interface do usuário com o último branch selecionado. [60771527]

Problemas conhecidos

makepkg2: /priorpackage não gera um relatório de comparação para pacotes MSIXVC2

Problema:
No makepkg2, usar o sinalizador /priorpackage ao empacotar pacotes MSIXVC2 não gera um relatório de comparação. A geração de relatórios de comparação não tem suporte para pacotes MSIXVC2 nesta versão.
Aplica-se a:
  • GDK de abril de 2026
Solução alternativa:
Nenhuma no momento.
Status:
Esse problema será corrigido em uma atualização futura do GDK.
[61771743]

makepkg2: layout.xml exige DisplayName em todos os recursos

Problema:
No makepkg2, o analisador de layout.xml exige o atributo DisplayName em todos os recursos, incluindo recursos ocultos em que um nome de exibição não faz sentido.
Aplica-se a:
  • GDK de abril de 2026
Solução alternativa:
Adicione um atributo DisplayName de espaço reservado a todos os recursos ocultos em layout.xml.
Status:
Esse problema será corrigido em uma atualização futura do GDK.
[61767246]

makepkg2: o sinalizador /contentid falha quando ContentId está ausente do MicrosoftGame.config

Problema:
No makepkg2, usar o sinalizador /contentid quando nenhum ContentId está especificado no MicrosoftGame.config resulta no seguinte erro.
/contentid specified on the command line does not match the ContentId derived from the MicrosoftGame.config file. Esse comportamento difere do makepkg, que aceitava o valor de /contentid diretamente nesse cenário. Aplica-se a:
  • GDK de abril de 2026
Solução alternativa:
Use /contentidoverride em vez de /contentid.
Status:
Esse problema será corrigido em uma atualização futura do GDK.
[61767256]

Os pacotes MSIXVC2 não podem ser carregados no Microsoft Partner Center por meio da interface do usuário da Web

Problema:
O upload de um pacote .msixvc para o Partner Center falha se ele tiver sido criado com as novas ferramentas makepkg2.
Aplica-se a:
  • Interface do usuário da Web do Partner Center
Solução alternativa:
Use uma das seguintes ferramentas para carregar pacotes MSIXVC2 no Partner Center.
Status:
O Partner Center será atualizado nos próximos meses para adicionar suporte a uploads de pacotes MSIXVC2 pela Web.

XboxPcTray.exe pode bloquear a desinstalação ou a atualização de pacotes MSIXVC2

Problema:
Às vezes, o XboxPcTray.exe mantém um identificador para a pasta Content do jogo, o que pode impedir a conclusão de operações de desinstalação ou atualização.
Aplica-se a:
  • GDK de abril de 2026
Solução alternativa:
Feche o aplicativo XBOX PC Tray antes de tentar desinstalar ou atualizar. Para fechá-lo, clique com o botão direito do mouse no ícone XboxPcTray na bandeja do sistema e selecione Quit. Você também pode encerrar o processo XboxPcTray.exe no Gerenciador de Tarefas.
Status:
Esse problema será corrigido em uma atualização futura do GDK.
[61618609]

Os pacotes MSIXVC2 não podem ser carregados por meio do Package Uploader

Problema:
O upload de um pacote .msixvc para o Partner Center por meio da ferramenta de linha de comando Package Uploader falha com um erro 400 (Bad Request) se o pacote tiver sido criado com a ferramenta makepkg2 com o sinalizador /msixvc2. Embora os pacotes MSIXVC e MSIXVC2 compartilhem a mesma extensão de arquivo .msixvc, os pacotes MSIXVC2 usam um formato interno diferente, ao qual o Package Uploader não oferece suporte no momento.
Aplica-se a:
  • CLI do Package Uploader (PackageUploader.exe)
Solução alternativa:
Use uma das seguintes ferramentas para carregar pacotes MSIXVC2.
Status:
Esse problema será resolvido em uma versão futura do Package Uploader.

Os pacotes MSIXVC2 no Partner Center aparecem com 1 byte de tamanho na interface do usuário

Problema:
O Partner Center mostra um tamanho incorreto para os pacotes MSIXVC2 carregados. Ele mostra 1 byte, independentemente do tamanho do pacote.
Aplica-se a:
  • Partner Center
Solução alternativa:
Nenhuma no momento.
Status:
Esse problema será corrigido em uma atualização futura das ferramentas do GDK.

Integração do Build With/Out Install (BWOI) com o MSBuild para o Visual Studio 2026

Problema:
A integração do Build With/Out Install (BWOI) com o MSBuild para o Visual Studio 2026 é ligeiramente diferente das versões anteriores. Nas versões atuais do Visual Studio 2026, a implementação do BWOI precisa ficar “presa” a um VCTargetsPath específico. Como resultado, todos os projetos são compilados com v145 ou clang-cl, mesmo que os valores de PlatformToolset estejam definidos como v142 ou v143. Esses conjuntos de ferramentas mais antigos normalmente compilam corretamente em cenários padrão do Visual Studio.
Aplica-se a:
  • GDK de abril de 2026
Solução alternativa:
Para obter detalhes sobre uma solução alternativa, consulte BWOIExample.
Status:
A equipe do GDK e a equipe do Visual Studio estão trabalhando para resolver esse problema em uma versão futura do Visual Studio.
[61855642]

Documentação

A documentação offline da versão de abril de 2026 do GDKX é instalada no seu PC de desenvolvimento pelo programa de instalação do GDKX. Depois de executar a instalação, o arquivo de Ajuda do GDKX (gdk.chm) fica em C:\Program Files (x86)\Microsoft GDK\Documentation.

Última modificação em 9 de novembro de 2026