安装 GDK 工具链

设置你的开发 PC、安装工具链并下载 GDK。请按顺序完成各步骤。后面的步骤依赖前面的步骤。

​

第 1 步:确认开发 PC 要求

​

操作系统

​

硬件

• 一台快速的现代 x64 PC,GDK 安装需 30 GB 空闲空间。
• 面向 XBOX 目标的开发建议使用 NVMe SSD(带散热片)、开发 PC 上一张 10 GbE 网卡、一台配 Cat 6a 网线的 10 GbE 交换机(开发 PC 与开发套件位于同一子网),以及一块支持 Thunderbolt 3 的主板。
• 用于验证显示功能的 4K 或 UHD、HDR 支持显示器。

已验证的 10 GbE 硬件参考

• Netgear XS708T 8 口交换机
• AQuantia Aqtion AQN-107 PCIe 10GBase-T 适配器
• Intel Ethernet Converged Network Adapter X540-T1
• Samsung SSD 970 EVO NVMe M.2 1 TB
• Cat 6a 以太网线缆

​

第 2 步:安装 Windows SDK

GDK 游戏基于 Win32,因此 Windows SDK 是开发体验的核心。它提供 Direct3D、XAudio、PIX for Windows API、核心 OS 服务、WINAPI_FAMILY_GAMES 分区、xgameplatform.lib、统一的 GameInput API 与进程生命周期管理 (PLM)。 要求的最低版本:Windows SDK 22000 或更高版本(Windows 11 SDK)。可单独安装,也可作为 Visual Studio 安装程序的可选组件安装。

​

第 3 步:安装 Visual Studio

请使用 Visual Studio 2022 或 Visual Studio 2026,并启用 C++ 工作负载。

​

第 4 步:下载并安装 GDK

1. 从 XBOX GDK 下载页面 下载 GDK,以及可选的 Game Core for XBOX。此操作需要 ID@XBOX 访问权限。
2. 以管理员身份运行安装程序。
3. 接受许可条款。
4. 选择 GDK,以及可选的 Game Core for XBOX 组件。
5. 等待安装完成,然后在提示时重启。

安装完成后,打开 Visual Studio 并确认 Gaming.Desktop.x64 与 Gaming.XBOX.Scarlett.x64 平台出现在 Configuration Manager 中。

​

GDK 中包含的内容

• Gaming Runtime: MSIXVC 打包、TCUI、Connected Storage、异步块、设备关联、用户、TTS、辅助功能与 Screen Time。
• Gaming Cloud Services: XSAPI、XAL、多人游戏网络、PlayFab,以及带应用内购买的 Store。
• Gaming device extensions: DirectX 12.x、Audio.x、PIX.x、XMemAlloc 以及其他主机专用的内存 API。

​

PC 与 XBOX 工具

PC 游戏: 使用标准 Visual Studio 工具与 PIX for Windows 在本地迭代、测试与调试。也可配置 VS Remote Tools 在实验室 PC 上复现问题。 XBOX 游戏: 使用 PIX for XBOX、xb* 命令行工具、XBOX Manager、Dev Home 与 XBOX Device Portal (XDP) 在 XBOX Series X|S 主机或 XBOX One 系列主机开发套件上远程迭代。

​

Microsoft 符号服务器

启用 Microsoft 符号服务器以获取 Gaming Runtime 符号。在 Visual Studio 中,转到 Debug > Options > Symbols,选择 Microsoft Symbol Servers。请参阅 Microsoft 公共符号服务器 文档。

​

Build Without Install (BWOI)

BWOI 让你的构建服务器无需运行安装程序即可使用 GDK。这对 CI 与受限的构建环境至关重要。将 GDK 安装载荷解压到一个已知目录,把构建环境变量指向它,然后用 msbuild 或你的工具链进行构建。

• BWOI 不会安装 Visual Studio VSIX 集成。
• 某些工具需要一次性提取步骤,例如 XBTC 与 makepkg 载荷。
• 每位开发者的开发套件与 PIX 仍以常规方式安装到工作站。

使用 BWOI 在容器化 CI 中运行 GDK 构建。

​

远程 Windows 游戏开发

使用远程游戏开发工具通过开发网络部署与调试到远程 Windows PC。这对多 PC 开发管线很有用——例如美术在 Windows 10 上、构建在 Server 2019 上,目标在另一台测试 PC 上。Hyper-V 或 VMware 适用于临时测试镜像。

​

后续步骤

在 Visual Studio 中打开一个自带示例,确认你的安装可用。