> ## 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 需求

### 作業系統

<Warning>
  GDK 的 Visual Studio (VSIX) 元件不支援 ARM 裝置。請在 x64 開發 PC 上安裝 GDK。
</Warning>

| 用途                            | 支援的版本                                                           |
| ----------------------------- | --------------------------------------------------------------- |
| 開發 XBOX 遊戲(用戶端)               | Windows 10 或 Windows 11(64 位元):Home、Pro 或 Enterprise。           |
| 開發 XBOX 遊戲(建置伺服器)             | Windows Server 2019(1809 或更新版本):Standard 或 Datacenter。          |
| 開發 Windows 遊戲(Gaming Runtime) | Windows 10 2019 年 5 月更新或更新版本(64 位元),或 Windows 11(64 位元)。        |
| 測試以 MSIXVC 封裝的 PC 遊戲          | Windows 10 2019 年 5 月更新或更新版本(64 位元),搭配 Gaming Services Runtime。 |

### 硬體

* 一台快速、現代化的 x64 PC,並有 30 GB 可用空間供 GDK 安裝使用。
* 針對以 XBOX 為目標的開發,請使用 NVMe SSD(含散熱片)、開發 PC 上的 10 GbE 網路卡、搭配 Cat 6a 纜線的 10 GbE 交換器(開發 PC 與 dev kit 位於同一子網路),以及支援 Thunderbolt 3 的主機板。
* 支援 4K 或 UHD、HDR 的顯示器,用於驗證顯示功能。

<Accordion title="已驗證的 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
  - Category 6a 乙太網路纜線
</Accordion>

## 第 2 步:安裝 Windows SDK

GDK 遊戲以 Win32 為基礎,因此 [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk/) 是開發體驗的核心。它提供 Direct3D、XAudio、PIX for Windows API、核心作業系統服務、`WINAPI_FAMILY_GAMES` 分割區、`xgameplatform.lib`、統一的 [GameInput](/build/core-features/common/input/overviews/input-overview) API,以及處理程序生命週期管理 (PLM)。

最低需求版本:Windows SDK 22000 或更新版本(Windows 11 SDK)。可獨立安裝,或作為 Visual Studio Installer 的選用元件安裝。

## 第 3 步:安裝 Visual Studio

使用 Visual Studio 2022 或 Visual Studio 2026,並搭配 C++ 工作負載。

<Note>
  如果你在安裝 GDK 之後才安裝新版本的 Visual Studio,請修復 GDK,使其與新版本整合。如果需要解除安裝 Visual Studio,請先解除安裝 GDK。
</Note>

<Tip>
  安裝 GDK 之前,請先建立系統還原點。
</Tip>

## 第 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 裝置延伸模組:** 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 系列主機 dev kit 上進行遠端反覆開發。

## Microsoft 符號伺服器

啟用 Microsoft 符號伺服器以取得 Gaming Runtime 符號。在 Visual Studio 中,前往**偵錯** > **選項** > **符號**,並選取 **Microsoft 符號伺服器**。請參閱 [Microsoft 公用符號伺服器](https://learn.microsoft.com/windows-hardware/drivers/debugger/microsoft-public-symbols)文件。

## 免安裝建置 (BWOI)

BWOI 讓你的建置伺服器不需執行安裝程式即可使用 GDK。這對 CI 與受限制的建置環境至關重要。將 GDK 安裝承載內容解壓縮到已知目錄,將建置環境變數指向該目錄,然後使用 `msbuild` 或你的工具鏈進行建置。

* BWOI 不會安裝 Visual Studio VSIX 整合。
* 某些工具需要一次性的解壓縮步驟,例如 XBTC 與 makepkg 承載內容。
* 每位開發者的 dev kit 與 PIX 仍以一般方式安裝在工作站上。

使用 BWOI 在容器化 CI 中執行 GDK 建置。

## 遠端 Windows 遊戲開發

使用遠端遊戲開發工具,透過開發網路部署並偵錯至遠端 Windows PC。這有助於多台 PC 的開發管線——例如,美術人員使用 Windows 10、組建在 Server 2019 上進行,而目標則是另一台測試 PC。Hyper-V 或 VMware 皆適用於臨時測試映像。

## 後續步驟

在 Visual Studio 中開啟隨附的範例,確認你的安裝可正常運作。

<Card title="GDK 範例" icon="arrow-right" href="/home/setup-install/samples">
  GDK 隨附的參考範例。
</Card>