QDoc용 Clang 설치하기

QDoc은 \fn 명령의 함수 시그니처뿐만 아니라 C++ 파일을 구문 분석할 때 Clang을 사용합니다. Clang은 LLVM 컴파일러 인프라 프로젝트의 일부입니다. 소스에서 QDoc을 빌드하려면 Clang 17.0 이상을 설치해야 합니다.

다양한 경로를 통해 Clang을 얻을 수 있습니다:

• Qt는 온라인 설치 관리자에서 Qt 바이너리에 사용되는 사전 빌드된 Clang 패키지를 제공합니다. 이를 통해 LLVM/Clang 라이브러리를 정적으로 연결할 수 있지만 Windows의 릴리스 빌드만 지원합니다.
• 리눅스 배포판은 종종 libclang-dev 또는 libclang-devel이라는 패키지를 제공합니다. Qt의 빌드 시스템은 CMake가 ClangConfig.cmake를 찾도록 지시하므로, QDoc을 빌드하려면 이 파일을 제공하는 패키지를 설치해야 합니다. QDoc을 실행하려면 libclang만 필요합니다.
• macOS에서는 Homebrew의 llvm 공식을 사용할 수도 있습니다.

사용자 지정 위치에 Clang을 설치하는 경우 CMake에 위치를 알려주어야 합니다. 이 작업은 Qt를 구성할 때 LLVM_INSTALL_DIR 환경 변수를 사용하여 LLVM 설치 경로를 지정하여 수행할 수 있습니다. 또는 CMAKE_PREFIX_PATH CMake 캐시 변수에 설치 경로를 추가할 수 있습니다.