在不安装 Microsoft 游戏开发工具包的情况下配置生成环境
本主题介绍如何在提取的 Microsoft 游戏开发工具包 (GDK) 中配置生成环境和命令提示符，因为它们在提取 Microsoft 游戏开发工具包 (GDK) 后需要采取一些额外的步骤才能正常工作。
环境变量命令文件
Microsoft 游戏开发工具包 (GDK) 中包含一组 .cmd 文件，用于定义环境变量。 需要使用它们来正确创建命令提示符以访问命令行操作（包括使用 MSBuild 进行构建）。
这些 .cmd 文件有两个实例。 可以在以下示例提取文件所在的位置找到它们。
- C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd
- C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingDesktopVars.cmd
检查这些文件可以帮助您更好地了解环境变量是如何定义和检测的。 大多数环境变量是根据 IF NOT 检查设置的，因此，如果在执行之前设置，它们可能被覆盖。
第一个输入变量 %1 用于确定平台和 Visual Studio 版本。 可用的值有：
- GamingXboxVS2019
- GamingXboxVS2022
- GamingXboxScarlettVS2019
- GamingXboxScarlettVS2022
- GamingDesktopVS2019
- GamingDesktopVS2022
此用法的一个示例 (从命令行) 是 GamingXboxVars.cmd GamingXboxVS2022。
这将设置带有环境变量的、为使用 Xbox 和 Visual Studio 2022 工作而定义的命令提示符。 以下各部分详细介绍了设置引用提取的工具包文件的命令提示符时必须替代哪些环境变量。
Gaming.Xbox.XboxOne.x64 和 Gaming.Xbox.Scarlett.x64 的环境变量配置。
在 Microsoft 游戏开发工具包 (GDK) 命令提示符中调用 GamingXboxVars.cmd 之前，应将以下环境变量设置为引用提取位置并替代本地安装检查。
- GXDKEDITION：游戏 Xbox 开发工具包 (GXDK) 的版本号。 例如，220300 指的是 2022 年 3 月的 Microsoft 游戏开发工具包 (GDK)。
- GameDK：Microsoft 游戏开发工具包 (GDK) 的根位置。
- GameDKLatest：根位置下的最新版本编号文件夹。
- WindowsSdkDir：Windows 10 SDK 的位置。
- GamingGRDKBuild：游戏运行时开发工具包 (GRDK) 特定文件的位置。
- GamingGXDKBuild：特定于 Microsoft 游戏开发工具包 (GDK) 的文件的位置。
- VSInstallDir：Visual Studio 的安装位置。
下面是将这些环境变量设置为指向示例提取文件的示例命令。
SET GXDKEDITION=220300
SET "GameDK=C:\ExtractedGDK\%GXDKEDITION%\Microsoft GDK\"
SET "GameDKLatest=%GameDK%%GXDKEDITION%\"
SET "WindowsSdkDir=C:\ExtractedWin10SDK\Windows Kits\10\"
SET "GamingGRDKBuild=%GameDKLatest%GRDK\"
SET "GamingGXDKBuild=%GameDKLatest%GXDK\"
SET "VSInstallDir=C:\Program Files\Microsoft Visual Studio\2022\Enterprise\"
使用上一部分中介绍的 GamingXboxVars.cmd 输入变量在 Xbox One 和 Xbox 系列 X|S 环境之间进行切换。
Gaming.Desktop.x64 的环境变量配置
在 Microsoft 游戏开发工具包 (GDK) 命令提示符中调用 GamingDesktopVars.cmd 之前，应将以下环境变量设置为引用提取位置并替代本地安装检查。
- GRDKEDITION：游戏运行时开发工具包 (GRDK) 的版本号。 例如，220300 指的是 2022 年 3 月的 Microsoft 游戏开发工具包 (GDK)。
- GameDK：Microsoft 游戏开发工具包 (GDK) 的根位置。
- GameDKLatest：根位置下的最新版本编号文件夹。
- WindowsSdkDir：Windows 10 SDK 的位置。
- GamingGRDKBuild：游戏运行时开发工具包 (GRDK) 文件的位置。
- VSInstallDir：Visual Studio 的安装位置。
下面是将这些环境变量设置为指向示例提取文件的示例命令。
SET GRDKEDITION=220300
SET "GameDK=C:\ExtractedGDK\%GRDKEDITION%\Microsoft GDK\"
SET "GameDKLatest=%GameDK%%GRDKEDITION%\"
SET "WindowsSdkDir=C:\ExtractedWin10SDK\Windows Kits\10\"
SET "GamingGRDKBuild=%GameDKLatest%GRDK\"
SET "VSInstallDir=C:\Program Files\Microsoft Visual Studio\2022\Enterprise\"
命令提示符设置
安装 Microsoft 游戏开发工具包 (GDK) 后，命令提示符将创建为相应 Microsoft 游戏开发工具包 (GDK) 命令提示 .cmd 文件的快捷方式。 以下是此命令提示符的一个示例。
C:\Windows\System32\cmd.exe /k "C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd" GamingXboxVS2022
使用前述内容创建快捷方式将提供与已安装的命令提示符脚本相同的环境设置。 包装脚本以设置上述环境变量，然后使用相应的输入变量加以执行，这是进行此配置的推荐方法。
Microsoft 游戏开发工具包 (GDK) 中的 Lib 和 Include 引用。
环境变量脚本为 Lib 和 Include 路径设置以下位置。 提供了以下针对 Gaming.Xbox.Scarlett.x64 的示例供参考，不应替代（在本示例中，MSVC Tool 版本是从 VCToolsVersoin 环境变量派生的）。
INCLUDE=C:\Program Files (x86)\Windows Kits\10\Include\um;C:\Program Files (x86)\Windows Kits\10\Include\shared;C:\Program Files (x86)\Windows Kits\10\Include\winrt;C:\Program Files (x86)\Windows Kits\10\Include\cppwinrt;C:\Program Files (x86)\Windows Kits\10\Include\ucrt;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\include\Scarlett;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\include;C:\ExtractedGDK\220300\Microsoft GDK\220300\GRDK\gamekit\include;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.30.30705\INCLUDE;
LIB=C:\Program Files (x86)\Windows Kits\10\Lib\um\x64;C:\Program Files (x86)\Windows Kits\10\Lib\ucrt\x64;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\lib\amd64\Scarlett;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\lib\amd64;C:\ExtractedGDK\220300\Microsoft GDK\220300\GRDK\gamekit\lib\amd64;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.30.30705\lib\x64;
LIBPATH=C:\Windows\Microsoft.NET\Framework\v4.0.30319;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\
Windows 10 SDK 中的 Lib 和 Include 引用
环境变量脚本为 Windows 10 SDK 的 Lib 和 Include 路径设置以下位置。 以下示例仅供参考，不应覆盖。
WindowsIncludeRoot=C:\Program Files (x86)\Windows Kits\10\Include\
WindowsLibRoot=C:\Program Files (x86)\Windows Kits\10\Lib\