安裝 GDK 工具鏈

設定開發 PC、安裝工具鏈並下載 GDK。請依序完成各步驟,後面的步驟依賴前面的步驟。

​

第 1 步:確認開發 PC 需求

​

作業系統

​

硬體

• 一台快速、現代化的 x64 PC,並有 30 GB 可用空間供 GDK 安裝使用。
• 針對以 XBOX 為目標的開發,請使用 NVMe SSD(含散熱片)、開發 PC 上的 10 GbE 網路卡、搭配 Cat 6a 纜線的 10 GbE 交換器(開發 PC 與 dev kit 位於同一子網路),以及支援 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
• Category 6a 乙太網路纜線

​

第 2 步:安裝 Windows SDK

GDK 遊戲以 Win32 為基礎,因此 Windows SDK 是開發體驗的核心。它提供 Direct3D、XAudio、PIX for Windows API、核心作業系統服務、WINAPI_FAMILY_GAMES 分割區、xgameplatform.lib、統一的 GameInput API,以及處理程序生命週期管理 (PLM)。 最低需求版本:Windows SDK 22000 或更新版本(Windows 11 SDK)。可獨立安裝,或作為 Visual Studio Installer 的選用元件安裝。

​

第 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 裝置延伸模組: 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 公用符號伺服器文件。

​

免安裝建置 (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 中開啟隨附的範例,確認你的安裝可正常運作。