跳轉到主要內容
本文說明 GDK 對 Visual Studio 2022 的支援。Visual Studio 2022 17.12 或 17.14 版支援 Microsoft Game Development Kit (GDK) 開發。依據 Visual Studio 產品生命週期與服務,為 17.12 與 17.14 版提供長期支援通道。
Visual Studio 2022 17.0 到 17.11 版已於 2026 年 1 月終止支援。

安裝 Visual Studio 2022

GDK 支援使用 Visual Studio 2022 的 Professional 版或 Enterprise 版進行開發。不支援 Community 版。
ARM 型裝置不支援 GDK Visual Studio 延伸模組 (VSIX) 元件。若要使用 GDK Visual Studio 專案範本、屬性頁與偵錯延伸模組,請在 x64 型開發電腦上安裝 GDK。
安裝 Visual Studio 2022 時,請在安裝期間選取 使用 C++ 的遊戲開發 工作負載,如下列螢幕擷取畫面所示。 使用 Visual Studio 2022 安裝使用 C++ 的遊戲開發工作負載 除了遊戲開發所需的核心 C++ 工具之外,請確定已安裝 Windows 10 SDK (22000) 元件,以提供使用 GDK 建置遊戲所需的 Windows SDK。您也可以使用 Windows SDK for Windows 11, Version 22H2 (10.0.22621) 或 Windows SDK for Windows 11, Version 24H2 (10.0.26100),但並非必要。 雖然並非必要,但安裝 使用 C++ 的桌面開發 工作負載可提供更多您可能覺得有用的工具與範例。例如,如果您使用 Clang/LLVM 工具組進行建置,則需要 使用 C++ 的桌面開發。

安裝選用工具組

使用 C++ 的遊戲開發 工作負載會安裝 Visual Studio 2022 版本的 MSVC 建置工具 (版本 v143)。除了 v143 工具組之外,GDK 也支援使用下列工具組進行建置:
  • v142 (Visual Studio 2019 工具組)
  • 適用於 Windows 的 C++ Clang 工具
這種彈性可讓您升級至 Visual Studio 2022 IDE,而不需要更新工具組。 您可以在 使用 C++ 的桌面開發 工作負載底下找到選用工具組,或在 Visual Studio 安裝對話方塊中搜尋 個別元件。 安裝 Visual Studio 2022 時選取選用工具組

為專案選取工具組

使用專案屬性頁中的 平台工具組 屬性指定專案要使用的工具組。 指定建置專案時要使用的工具組 您也可以在專案檔中手動指定 PlatformToolset 屬性,如下列屬性群組所示。

使用 Visual Studio 2022 偵錯 XBOX 專案

若要使用 Visual Studio 2022 進行偵錯,請使用 2022 年 3 月 (或更新版本) 的 GDK 建置您要偵錯的遊戲。存在此相依性的原因是,這些 GDK 版本中隨附的 Game OS 包含使用 Visual Studio 2022 進行偵錯所需的二進位檔。如果您嘗試對較舊的 Game OS 使用 Visual Studio 2022 進行偵錯,會看到下列錯誤訊息。 嘗試對早於 2022 年 3 月 GDK 隨附版本的 Game OS 使用 Visual Studio 2022 偵錯工具 在 Visual Studio 2022 中使用 偵錯 功能表底下的 附加 對話方塊時,請在 連線類型 下拉式清單中選取 XBOX Direct Connection,並在 連線目標 文字方塊中輸入主機的 Host IP 位址。使用 xbconnect 命令列工具判斷 Host IP。 使用 Visual Studio 2022 附加對話方塊
這些值與使用 Visual Studio 2019 附加時所輸入的值不同。使用 Visual Studio 2019 時,連線類型為 Remote no authentication,IP 位址為主機的 System IP 位址。

Visual Studio 2022 服務模型

Visual Studio 2022 包含新的服務模型,您可以用來選取服務基準,然後只取得該基準的更新。此新模型取代了先前 Visual Studio 版本的服務模型,先前的模型強烈建議使用最新可用版本。如需詳細資訊,請參閱 Visual Studio 產品生命週期與服務。

回報錯誤

Visual C++ 編譯器的錯誤報告請 (盡可能) 透過 Visual Studio 的 回報問題… 進行回報。如需詳細資訊,請參閱 Microsoft Docs 與開發人員社群網站。請務必閱讀此頁面,以了解如何為編譯器建立良好錯誤報告的詳細資訊。
如果需要私人資訊才能重現問題,您可以在公開報告問題中新增標示為「僅限 Microsoft」的註解。
若要回報 clang/LLVM for Windows 編譯器的錯誤,請使用 https://bugs.llvm.org/ 若要回報 Microsoft 標準 C++ 程式庫 (又稱 STL) 的錯誤,請使用 https://github.com/microsoft/STL/issues 一如往常,對於需要提報的重大問題,歡迎與您的 Microsoft 代表聯絡。

已知問題

  • Game OS 不支援 C++20 P0355R7 <chrono> Calendars And Time Zones 中新增的 std:chrono 時區功能,因為 XVD 映像中不包含 icu.dll、icuin.dll、icuuc.dll 或相關聯的資料檔案。如果您使用這些函式,應用程式會在執行階段擲回 C++ 例外狀況。PR0355R7 中的行事曆功能則受支援。

另請參閱

Visual Studio XBOX 開發的 Visual Studio 專案範本 XBOX 開發的 Visual Studio 屬性 使用 Visual Studio 偵錯 XBOX 專案
最後修改於 2026年10月8日