> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar o Visual Studio para XBOX Series X|S e XBOX One

> Configurar o Visual Studio para builds de XBOX Series X|S e XBOX One

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.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_scarlett_config.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=43dd3823fa1808f1d6991e6a4f5c3471" alt="Captura de tela de um modelo do Visual Studio mostrando as plataformas Gaming.Xbox.XboxOne.x64 e Gaming.Xbox.Scarlett.x64" width="228" height="121" data-path="images/gdk/tools/vs_scarlett_config.png" />

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.

```cpp theme={null}
_GAMING_XBOX_SCARLETT
```

Essa plataforma adiciona os seguintes diretórios à lista de caminhos de inclusão e de biblioteca usando propriedades do msbuild.

```cpp theme={null}
C:\Program Files (x86)\Microsoft GDK\260400\GXDK\gameKit\Include\Scarlett
C:\Program Files (x86)\Microsoft GDK\260400\GXDK\gameKit\lib\amd64\Scarlett
```

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.

```cpp theme={null}
msbuild MySolution.sln /p:Configuration=Debug /p:Platform="Gaming.Xbox.Scarlett.x64"
```

## 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](/pt-BR/build/console-features/porting-from-xbox-one-era/porting-guide-for-existing-era).

## Veja também

[Visual Studio](/pt-BR/tools/tools-console/visualstudio/visualstudio)


## Related topics

- [Propriedades do Visual Studio para desenvolvimento para XBOX](/pt-BR/tools/tools-console/visualstudio/durango-property-pages.md)
- [Modelos de projeto no Visual Studio para desenvolvimento para XBOX](/pt-BR/tools/tools-console/visualstudio/durango-visual-studio-templates.md)
- [Visual Studio](/pt-BR/tools/tools-console/visualstudio/index.md)
- [Visual Studio para desenvolvimento para console](/pt-BR/tools/tools-console/visualstudio/visualstudio.md)
- [Depurar projetos XBOX usando o Visual Studio](/pt-BR/tools/tools-console/visualstudio/debugging-with-visualstudio.md)