> ## 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.
# 安装 GDK 工具链
> 在开发 PC 上安装 Windows SDK、Visual Studio 与 XBOX Game Development Kit 的要求、先决条件与分步说明。
设置你的开发 PC、安装工具链并下载 GDK。请按顺序完成各步骤。后面的步骤依赖前面的步骤。
## 第 1 步:确认开发 PC 要求
### 操作系统
GDK 的 Visual Studio (VSIX) 组件不支持 ARM 设备。请在 x64 开发 PC 上安装 GDK。
| 用途 | 支持系统 |
| ----------------------------- | ------------------------------------------------------------------- |
| 开发 XBOX 游戏(客户端) | Windows 10 或 Windows 11(64 位):Home、Pro 或 Enterprise。 |
| 开发 XBOX 游戏(构建服务器) | Windows Server 2019(1809 或更高版本):Standard 或 Datacenter。 |
| 开发 Windows 游戏(Gaming Runtime) | Windows 10 May 2019 Update 或更高版本(64 位),或 Windows 11(64 位)。 |
| 测试 MSIXVC 打包的 PC 游戏 | Windows 10 May 2019 Update 或更高版本(64 位),并安装 Gaming Services Runtime。 |
### 硬件
* 一台快速的现代 x64 PC,GDK 安装需 30 GB 空闲空间。
* 面向 XBOX 目标的开发建议使用 NVMe SSD(带散热片)、开发 PC 上一张 10 GbE 网卡、一台配 Cat 6a 网线的 10 GbE 交换机(开发 PC 与开发套件位于同一子网),以及一块支持 Thunderbolt 3 的主板。
* 用于验证显示功能的 4K 或 UHD、HDR 支持显示器。
- 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](https://developer.microsoft.com/windows/downloads/windows-sdk/) 是开发体验的核心。它提供 Direct3D、XAudio、PIX for Windows API、核心 OS 服务、`WINAPI_FAMILY_GAMES` 分区、`xgameplatform.lib`、统一的 [GameInput](/build/core-features/common/input/overviews/input-overview) API 与进程生命周期管理 (PLM)。
要求的最低版本:Windows SDK 22000 或更高版本(Windows 11 SDK)。可单独安装,也可作为 Visual Studio 安装程序的可选组件安装。
## 第 3 步:安装 Visual Studio
请使用 Visual Studio 2022 或 Visual Studio 2026,并启用 C++ 工作负载。
如果在安装 GDK 之后再安装新版本的 Visual Studio,请修复 GDK,使其与新版本集成。若要卸载 Visual Studio,请先卸载 GDK。
安装 GDK 前请先创建一个系统还原点。
## 第 4 步:下载并安装 GDK
1. 从 [XBOX GDK 下载页面](https://aka.ms/gdkdl) 下载 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 公共符号服务器](https://learn.microsoft.com/windows-hardware/drivers/debugger/microsoft-public-symbols) 文档。
## 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 中打开一个自带示例,确认你的安装可用。
GDK 附带的参考示例。
## Related topics
- [设置并安装 GDK](/zh-CN/home/setup-install/get-started.md)
- [GDK 示例](/zh-CN/home/setup-install/samples.md)
- [使用 GDKX 构建并运行你的第一款主机游戏](/zh-CN/home/build-first-title/first-console-title-walkthrough.md)
- [使用 GDK 工具安装并启动 PC 游戏](/zh-CN/tools/tools-pc/launching-on-pc.md)
- [创建游戏包并在合作伙伴中心上传](/zh-CN/publishing/game-publishing/tutorial-xbox-managed/how-to-create-a-package.md)