Visual Studio 2019 16.0 到 16.10 版已於 2022 年 10 月終止支援。16.11 版也已結束主流支援。
安裝 Visual Studio 2019
GDK 支援使用 Visual Studio 2019 的 Professional 版或 Enterprise 版進行開發。不支援 Community 版。安裝 Visual Studio 2019 時,請在安裝期間選取 使用 C++ 的遊戲開發 工作負載,如下列螢幕擷取畫面所示。
自 2024 年 10 月版本起,不再支援 Visual Studio 2017 v141 工具組。
clang/LLVM for Windows (ClangCl) 專案支援
Visual Studio 2019 也支援 clang/LLVM for Windows 開發。此支援需要安裝 C++ Clang-cl for Windows 與 C++ Clang-cl for v142 build tools (x64/x86) 這兩個個別元件。 如需詳細資訊,請參閱 Microsoft Game Development Kit (GDK) Clang 文章與 Microsoft Docs。Build Tools 版本
依照建置時安裝/不安裝的指示,使用 Build Tools for Visual Studio 2019 搭配 Microsoft GDK 標頭、程式庫與工具進行建置。- 使用 使用 C++ 的桌面開發 工作負載,它會安裝適用於 PlatformToolset
v142的 Visual C++ 編譯器。您也可以依照本文稍早的指示選取支援ClangCl的元件。 - 安裝 Windows SDK,或以 NuGet 套件的形式使用它。
Build Tools 版本不支援延伸模組,因此您無法為 Build 版本安裝 Microsoft GDK 的 VSIX 套件。此限制表示它不支援部署或偵錯,但您可以使用命令列工具。
將現有的 Visual Studio 2017 專案移轉至 Visual Studio 2019
在大多數情況下,Visual Studio 隨附的升級精靈可以將您的專案移轉至 Visual Studio 2019,而不需要任何其他變更。當您在 Visual Studio 2019 中開啟 Visual Studio 2017 專案時,會看到下列 檢閱方案動作 對話方塊,提示您進行升級。若要升級專案,請選取 確定。
手動將專案升級至 Visual Studio 2019
如果您想要直接編輯專案檔 (.vcxproj) 來升級專案,請進行下列變更。- 將所有
PlatformToolset執行個體從v141變更為v142。下列範例顯示如何進行此變更。
- 重建專案。
使用特定版本
根據預設,Visual Studio 安裝程式一律會下載最新版本。在企業環境中,您可以使用離線配置來控制特定版本。如需詳細資訊,請參閱控制 Visual Studio 部署的更新。該文章也提供有關移除 VS 通知 圖示的資訊。 從 Visual Studio 2019 版本下載特定版本的 Visual Studio 2019。已知問題
- 使用
/fp:fast建置時,DirectXMath*IsNan函式在 Visual Studio 2019 中可能會失敗。修正方式是使用 Visual Studio 2019 (16.3 或更新版本)。否則,您可以在使用這些函式的位置周圍放置#pragma float_control陳述式來因應此問題。 - GDK 開發僅支援 64 位元原生編譯器工具組。在 Visual C++
vcxproj中,請在 globals 屬性中設定此工具組:
- 在早於 v11 的 clang/LLVM for Windows 版本中,先行編譯標頭有已知問題。視您的 PCH 與 C++ 範本使用方式而定,您可能需要新增
-fno-pch-instantiate-templates才能成功建置。 - 透過 Microsoft Update 提供的 .NET Core 2.1 更新可能會封鎖 GDK 安裝。如需此問題的詳細資訊,請參閱 .NET Core 2.1 終止支援通知。若要解決此問題:
- 執行 Visual Studio 安裝程式
- 選取 Visual Studio 2019 的 修改 按鈕
- 選取 個別元件 索引標籤,並移除 .NET Core 2.1 Runtime (LTS) 元件
- 重試解除安裝並重新安裝 GDK
回報錯誤
Visual C++ 編譯器的錯誤請 (盡可能) 透過 Visual Studio 的 回報問題… 進行回報。請參閱 Microsoft Docs 與開發人員社群網站。如需為編譯器建立良好錯誤報告的詳細資訊,請參閱此頁面。如果需要其他 NDA 資訊才能重現問題,您可以在公開報告問題中新增標示為「僅限 Microsoft」的註解。
