GDK에서 Clang/LLVM 사용하기

​

필요한 Visual Studio 버전 및 구성 요소

​

컴파일러 및 링커 스위치

  -Wno-c++98-compat -Wno-c++98-compat-pedantic -Wno-reserved-id-macro
  -Wno-pragma-pack -Wno-unknown-pragmas
  -Wno-unused-command-line-argument

​

지원되는 CPU 내장 함수

• https://walbourn.github.io/directxmath-3.14/

​

msbuild와 함께 Clang/LLVM 사용

<PlatformToolset>ClangCl</PlatformToolset>

1>Game.cpp(56,13): warning : Game.cpp: TODO in Update [-W#pragma-messages]
1>Game.cpp(58,5): warning : expression result unused [-Wunused-value]
1>Game.cpp(79,13): warning : Game.cpp: TODO in Render [-W#pragma-messages]
1>Game.cpp(81,5): warning : expression result unused [-Wunused-value]
1>Game.cpp(137,13): warning : Game.cpp: TODO in CreateDeviceDependentResources [-W#pragma-messages]
1>Game.cpp(139,5): warning : expression result unused [-Wunused-value]
1>Game.cpp(145,13): warning : Game.cpp: TODO in CreateWindowSizeDependentResources [-W#pragma-messages]

​

cmake와 함께 Clang/LLVM 사용

​

CMakeExample 사용

1. Visual Studio의 로컬 폴더 열기 옵션을 사용하여 루트 CMakeExample 폴더의 Desktop 폴더를 엽니다.

​

CMakePresets.json 통합

2. 솔루션 탐색기에서 CMakePresets.json 파일을 두 번 클릭합니다.

"cacheVariables": {
  "XdkEditionTarget": "250400",
  "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}"
}

3. x64-Debug-Clang 또는 x64-Release-Clang 사전 설정을 선택합니다.

​

CMakeSettings.json 통합

2. 솔루션 탐색기에서 CMakeSettings.json 파일을 두 번 클릭합니다.
3. 다음 그림과 같이 “PLUS” 아이콘을 선택하고 “x64-Clang-Debug” 및/또는 “x64-Clang-Release”를 선택합니다. 변경 사항을 저장합니다.

4. “Edit Json”을 클릭한 다음 다음 예제와 같이 다른 구성의 variables 섹션을 잘라내어 새 Clang 구성에 붙여넣습니다. XDKEditionTarget 값을 QFE 수준을 포함한 GDK 버전에 적합한 값으로 설정합니다.

"variables": [
  {
    "name": "XdkEditionTarget",
    "value": "210400",
    "type": "STRING"
  }
]

5. 모든 변경 사항을 저장한 후 빌드 구성 드롭다운에서 x64-Clang-Debug 또는 x64-Clang-Release를 선택하고 빌드합니다.

​

CMakeGDKExample 사용

1. Visual Studio의 로컬 폴더 열기 옵션을 사용하여 CMakeGDKExample 폴더를 엽니다.

​

CMakePresets.json 통합

2. 솔루션 탐색기에서 CMakePresets.json 파일을 두 번 클릭합니다.

"cacheVariables": {
  "XdkEditionTarget": "250400",
  "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}"
}

3. x64-Desktop-Clang 사전 설정을 선택합니다.

​

CMakeSettings.json 통합

2. 솔루션 탐색기에서 CMakeSettings.json 파일을 두 번 클릭합니다.
3. 편집하려는 구성을 선택하고 Toolset 값을 “clang_cl_x64”로 설정합니다. 저장하고 닫습니다.

4. XBOX One 및 XBOX Series X|S 구성의 경우 Edit Json을 선택하고 XdkEditionTarget 변수가 GDK 에디션 및 QFE 수준과 일치하는지 확인합니다.
5. 구성 드롭다운에서 원하는 값을 선택하고 빌드 메뉴에서 모두 다시 빌드를 선택합니다.
6. 파일 -> 열기 -> 프로젝트/솔루션을 사용하여 생성된 솔루션/프로젝트를 선택합니다. 예:

​

지원 받기

​

알려진 문제

• Clang/LLVM 도구 집합은 특히 -Wall -Wextra -Wpedantic을 사용할 때 Visual C++보다 훨씬 더 자세한 출력을 제공합니다. 최소한 명령줄이나 #pragma로 다음 경고를 억제하세요.

#ifdef __clang__
#pragma clang diagnostic ignored "-Wc++98-compat"
#pragma clang diagnostic ignored "-Wc++98-compat-pedantic"
#pragma clang diagnostic ignored "-Wgnu-anonymous-struct"
#pragma clang diagnostic ignored "-Wlanguage-extension-token"
#pragma clang diagnostic ignored "-Wnested-anon-types"
#pragma clang diagnostic ignored "-Wreserved-id-macro"
#pragma clang diagnostic ignored "-Wunknown-pragmas"
#endif

• Microsoft Game Development Kit (GDK) 도구는 디버깅 기호에 대해 Microsoft PDB에서만 작동하며, LLVM .ld 파일에서 방출되는 CodeView 또는 DWARF 디버깅 정보는 지원하지 않습니다.
• Clang/LLVM의 링크 타임 코드 생성 구현은 Microsoft Visual C++ 솔루션과 명확하게 다릅니다. 링크 타임 코드 생성을 사용하는 코드는 MSVC와 clang/LLVM 간에 혼합할 수 없습니다.
• 2022년 10월 릴리스 및 Windows SDK (10.0.22621) 기준으로, C++ 정적 라이브러리에는 eXtended Flow Control Guard (XFG) 메타데이터가 포함됩니다. v15 릴리스 이전의 ld 링커는 이러한 라이브러리를 사용할 때 항상 무해한 경고를 방출합니다.

lld-link: warning/error: ignoring unknown debug$S subsection kind 0xFF in file xgameruntime.lib

​

함께 보기