Pular para o conteúdo principal
Você pode usar o Visual Studio para criar as versões para XBOX Series X|S e para XBOX One do seu título em um único projeto ou solução. Ao usar o Visual Studio dessa forma, você pode gerenciar com mais facilidade as diferenças de código-fonte e de configuração de build necessárias para criar um título voltado tanto para a geração XBOX One quanto para a geração XBOX Series X|S. Dependendo da estrutura do seu código e do design do seu processo de build, você pode optar por criar as versões para XBOX One e para XBOX Series X|S de um determinado binário no mesmo projeto ou em projetos diferentes dentro da mesma solução. Para binários em que o código é praticamente idêntico entre o XBOX Series X|S e o XBOX One (por exemplo, código não gráfico), fazer o build a partir do mesmo projeto provavelmente faz sentido. Para projetos em que o código diverge consideravelmente entre as duas plataformas, projetos separados podem ser mais fáceis de gerenciar. Use o conceito de plataforma do Visual Studio para separar as configurações de build do XBOX Series X|S das configurações necessárias para o build do XBOX One. Os projetos que você cria usando os modelos do Visual Studio fornecidos pelo Microsoft Game Development Kit (GDK) contêm definições para as plataformas XBOX One e XBOX Series X|S. O nome da plataforma XBOX One é Gaming.Xbox.XboxOne.x64. O nome da plataforma XBOX Series X|S é Gaming.Xbox.Scarlett.x64, conforme mostrado na captura de tela a seguir. Captura de tela de um modelo do Visual Studio mostrando as plataformas Gaming.Xbox.XboxOne.x64 e Gaming.Xbox.Scarlett.x64 As plataformas Gaming.Xbox.XboxOne.x64 e Gaming.Xbox.Scarlett.x64 especificam as definições de pré-processador, os caminhos de inclusão e de biblioteca e outras configurações necessárias para criar seu título para XBOX One ou XBOX Series X|S. Por exemplo, a plataforma Gaming.Xbox.Scarlett.x64 define a seguinte definição de pré-processador.
Essa plataforma adiciona os seguintes diretórios à lista de caminhos de inclusão e de biblioteca usando propriedades do msbuild.
A plataforma Gaming.Xbox.XboxOne.x64 faz as alterações correspondentes no ambiente de build necessárias para criar a versão para XBOX One do seu título. Especifique essas plataformas na linha de comando ao fazer o build com o msbuild, conforme mostrado no exemplo de código a seguir.

​
Usar outros sistemas de build

Se o seu sistema de build não for o Visual Studio e o msbuild, você poderá determinar as alterações que precisa fazer no seu próprio sistema de build para o desenvolvimento entre gerações comparando as versões para XBOX Series X|S e para XBOX One dos arquivos .targets e .props do msbuild incluídos no GDK. Esses arquivos são instalados nos diretórios Gaming.Xbox.Scarlett.x64 e Gaming.Xbox.XboxOne.x64 em C:\Program Files (x86)\Microsoft GDK\260400\GXDK\VS2019\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms. Para obter mais informações sobre as configurações específicas necessárias para fazer o build sem usar o Visual Studio, consulte Guia de portabilidade do Microsoft Game Development Kit para XBOX One.

​
Veja também

Visual Studio
Última modificação em 8 de outubro de 2026