Skip to main content
이 문서에서는 Visual Studio 2019용 Microsoft Game Development Kit (GDK) 지원에 대해 설명합니다. Visual Studio 2019 버전 16.11이 GDK 개발을 지원합니다.
Visual Studio 2019 버전 16.0부터 16.10까지는 2022년 10월부로 지원이 종료되었습니다. 버전 16.11 역시 주 지원(main-stream support)에서 벗어났습니다.

Visual Studio 2019 설치

GDK는 Visual Studio 2019의 Professional 에디션 또는 Enterprise 에디션을 사용한 개발을 지원합니다. Community 에디션은 지원되지 않습니다. Visual Studio 2019를 설치할 때, 다음 스크린샷과 같이 설정 중에 C++를 사용한 게임 개발 워크로드를 선택하세요. 게임 개발에 필요한 핵심 C++ 도구 외에도 GDK로 게임을 빌드하는 데 필요한 Windows SDK를 제공하려면 Windows 10 SDK (22000) 구성 요소가 설치되어 있는지 확인하세요. Windows 11용 Windows SDK, 버전 22H2 (10.0.22621) 또는 Windows 11용 Windows SDK, 버전 24H2 (10.0.26100)도 사용할 수 있지만 필수는 아닙니다. 필수는 아니지만 C++를 사용한 데스크톱 개발 워크로드를 설치하면 유용하게 사용할 수 있는 추가 도구와 샘플이 제공됩니다. MSVC 빌드 도구의 v142 버전은 C++를 사용한 게임 개발 워크로드와 함께 설치됩니다.
Visual Studio 2017 v141 도구 세트는 2024년 10월 릴리스부터 더 이상 지원되지 않습니다.

Windows용 clang/LLVM (ClangCl) 프로젝트 지원

Visual Studio 2019는 Windows 개발용 clang/LLVM도 지원합니다. 이 지원을 사용하려면 개별 구성 요소인 Windows용 C++ Clang-cl 및 **v142 빌드 도구용 C++ Clang-cl (x64/x86)**을 설치해야 합니다. 자세한 내용은 Microsoft Game Development Kit (GDK) Clang 문서와 Microsoft Docs를 참조하세요.

Build Tools 에디션

Build With/Out Install 지침을 따라 Microsoft GDK 헤더, 라이브러리, 도구로 빌드하려면 Build Tools for Visual Studio 2019를 사용하세요.
  • PlatformToolset v142용 Visual C++ 컴파일러를 설치하는 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 프로젝트를 열면 업그레이드하라는 다음 Review Solution Actions 대화 상자가 표시됩니다. 프로젝트를 업그레이드하려면 확인을 선택합니다. 빌드 도구를 업그레이드하지 않고 Visual Studio 2019 IDE만 사용할 수도 있습니다. 이렇게 하려면 Review Solution Actions 대화 상자에서 취소를 선택하세요.

프로젝트를 Visual Studio 2019로 수동 업그레이드

프로젝트 파일(.vcxproj)을 직접 편집하여 프로젝트를 업그레이드하려면 다음과 같이 변경합니다.
  1. PlatformToolset의 모든 인스턴스를 v141에서 v142로 변경합니다. 다음 예제는 이 변경 방법을 보여줍니다.
  1. 프로젝트를 다시 빌드합니다.

특정 버전 사용

기본적으로 Visual Studio Installer는 항상 최신 릴리스를 다운로드합니다. Enterprise 환경에서는 오프라인 레이아웃을 사용하여 특정 버전을 제어할 수 있습니다. 자세한 내용은 Visual Studio 배포 업데이트 제어를 참조하세요. 이 문서에서는 VS notification 아이콘을 제거하는 방법에 대한 정보도 제공합니다. 특정 버전의 Visual Studio 2019는 Visual Studio 2019 Releases에서 다운로드할 수 있습니다.

알려진 문제

  • DirectXMath *IsNan 함수는 /fp:fast로 빌드된 경우 Visual Studio 2019에서 실패할 수 있습니다. 해결책은 Visual Studio 2019 (16.3 이상)를 사용하는 것입니다. 그렇지 않은 경우 해당 함수 주위에 #pragma float_control 문을 배치하여 해결할 수 있습니다.
  • GDK 개발에는 64비트 네이티브 컴파일러 도구 세트만 지원됩니다. Visual C++ vcxproj에서 globals 속성에 이 도구 세트를 설정합니다.
  • v11 이전의 Windows용 clang/LLVM 버전에서는 사전 컴파일된 헤더에 알려진 문제가 있습니다. PCH 및 C++ 템플릿 사용에 따라 성공적으로 빌드하려면 -fno-pch-instantiate-templates를 추가해야 할 수도 있습니다.
  • Microsoft Update를 통해 제공되는 .NET Core 2.1 업데이트로 인해 GDK 설치가 차단될 수 있습니다. 이 문제에 대한 자세한 내용은 .NET Core 2.1 지원 종료 알림을 참조하세요. 이 문제를 해결하려면:
    • Visual Studio Installer 실행
    • Visual Studio 2019에 대한 수정 버튼 선택
    • 개별 구성 요소 탭을 선택하고 .NET Core 2.1 Runtime (LTS) 구성 요소 제거
    • GDK 제거 및 재설치 다시 시도

버그 보고

Visual C++ 컴파일러에 대한 버그는 가능하면 Visual Studio _Report a Problem…_을 통해 보고하세요. Microsoft DocsDeveloper Community 웹사이트를 참조하세요. 컴파일러에 대한 좋은 버그 보고서 작성 방법에 대한 자세한 내용은 이 페이지를 참조하세요.
이슈를 재현하는 데 다른 NDA 정보가 필요한 경우 “Microsoft only”로 표시된 공개 보고 이슈에 댓글을 추가할 수 있습니다.
Windows용 clang/LLVM 컴파일러에 대한 버그 보고는 https://bugs.llvm.org/를 사용하세요. Microsoft Standard C++ Library(STL이라고도 함)에 대한 버그 보고는 https://github.com/microsoft/STL/issues를 사용하세요. 에스컬레이션이 필요한 중요한 문제는 언제든지 _Microsoft 담당자_에게 문의하세요.

참고 항목

Visual Studio Visual Studio 제품 수명 주기 및 서비싱
마지막 수정일 2026년 8월 17일