为 XBOX Series X|S 与 XBOX One 配置 Visual Studio - XBOX Game Development Documentation

你可以在单个项目或解决方案中使用 Visual Studio 同时构建游戏的 XBOX Series X|S 版本和 XBOX One 版本。以这种方式使用 Visual Studio，你可以更方便地管理同时面向 XBOX One 和 XBOX Series X|S 两代平台的游戏所需的源代码和生成配置差异。根据你的代码结构和生成流程的设计，可以选择在同一个项目中构建给定二进制文件的 XBOX One 和 XBOX Series X|S 版本，或在同一解决方案中使用不同的项目分别构建它们。对于代码在 XBOX Series X|S 和 XBOX One 之间基本一致的二进制文件（例如非图形代码），使用同一个项目进行构建通常是合理的选择。而对于代码在两个平台之间差异较大的项目，采用独立的项目可能更易于管理。利用 Visual Studio 中的平台概念，可以将 XBOX Series X|S 版本的生成配置设置与 XBOX One 版本所需的设置分开。使用 Microsoft Game Development Kit (GDK) 提供的 Visual Studio 模板创建的项目，包含针对 XBOX One 和 XBOX Series X|S 两个平台的定义。XBOX One 平台的名称为 Gaming.Xbox.XboxOne.x64。XBOX Series X|S 平台的名称为 Gaming.Xbox.Scarlett.x64，如下面的截图所示。 Gaming.Xbox.XboxOne.x64 和 Gaming.Xbox.Scarlett.x64 平台指定了为 XBOX One 或 XBOX Series X|S 构建游戏所需的预处理器定义、include 与库路径以及其他设置。例如，Gaming.Xbox.Scarlett.x64 平台会设置以下预处理器定义。

_GAMING_XBOX_SCARLETT

该平台通过使用 msbuild 属性将以下目录添加到 include 与库路径列表中。

C:\Program Files (x86)\Microsoft GDK\260400\GXDK\gameKit\Include\Scarlett
C:\Program Files (x86)\Microsoft GDK\260400\GXDK\gameKit\lib\amd64\Scarlett

Gaming.Xbox.XboxOne.x64 平台会对构建环境进行相应的更改，以便构建游戏的 XBOX One 版本。使用 msbuild 进行构建时，可以在命令行上指定这些平台，如下面的代码示例所示。

msbuild MySolution.sln /p:Configuration=Debug /p:Platform="Gaming.Xbox.Scarlett.x64"

使用其他生成系统

如果你的生成系统不是 Visual Studio 和 msbuild，你可以通过比较 GDK 附带的 msbuild .targets 与 .props 文件的 XBOX Series X|S 版本和 XBOX One 版本，来确定为跨代开发需要对自己的生成系统进行哪些更改。这些文件安装在 C:\Program Files (x86)\Microsoft GDK\260400\GXDK\VS2019\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms 下的 Gaming.Xbox.Scarlett.x64 和 Gaming.Xbox.XboxOne.x64 目录中。有关不使用 Visual Studio 构建所需具体设置的更多信息，请参阅面向 XBOX One 的 Microsoft Game Development Kit 移植指南。

另请参阅

Visual Studio

​使用其他生成系统

​另请参阅

使用其他生成系统

另请参阅