QDoc용 Clang 설치

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

설치 옵션

Qt의 사전 빌드 패키지 (권장)

Qt는 Qt의 공식 빌드에 사용되며 테스트를 거친, 공식적으로 지원되는 사전 빌드된 LLVM/Clang 패키지를 제공합니다:

• 다운로드 주소: https://download.qt.io/development_releases/prebuilt/libclang/qt/.
• Windows, macOS 및 Linux에서 사용할 수 있습니다.
• LLVM/Clang 라이브러리의 정적 링크를 지원합니다.
• QDoc 요구 사항 및 Qt의 CI와 버전이 일치합니다.

시스템 패키지 관리자

Qt의 사전 빌드된 패키지 대신, 시스템 패키지 관리자를 통해 Clang을 설치할 수 있습니다. QDoc은 특히 Clang 컴파일러 라이브러리와 해당 CMake 구성 파일이 필요합니다. 의존성은 다음과 같습니다:

• llvm-<version> (인프라)
• clang-<version> (컴파일러 및 라이브러리)
• libclang-<version>-dev (개발 헤더)
• libclang-cpp<version>-dev (C++ API 개발 파일)

다음은 널리 사용되는 리눅스 배포판과 macOS에서 패키지 관리자를 호출하는 일반적인 방법입니다.

리눅스

대부분의 배포판에서 LLVM과 Clang은 별도의 패키지로 제공됩니다. ClangConfig.cmake 파일을 제공하는 (버전 지정된) -dev 패키지를 설치해야 합니다.

• 데비안/우분투: apt install libclang-dev clang libclang-cpp-dev
• Fedora/RHEL: dnf install clang-devel
• Arch Linux: pacman -S clang llvm

macOS

Homebrew의 llvm 포뮬러를 사용하세요:

• brew install llvm
• ARM64 기반 Mac의 경우: 다음을 사용하여 구성하십시오 LLVM_INSTALL_DIR="/opt/homebrew/opt/llvm"
• Intel 기반 Mac의 경우: 다음을 사용하여 구성하십시오 LLVM_INSTALL_DIR="/usr/local/opt/llvm"

구성

Qt Location이 LLVM/Clang 라이브러리를 찾을 수 없는 경우, 플랫폼별 설치 안내와 해당 시스템에 필요한 정확한 구성 명령어를 표시합니다.

사용자 정의 LLVM 설치 위치를 수동으로 지정하려면:

• LLVM_INSTALL_DIR 변수를 설정하십시오: configure LLVM_INSTALL_DIR="/path/to/llvm" FEATURE_clang=ON
• 또는 CMAKE_PREFIX_PATH 에 다음을 추가하십시오: configure CMAKE_PREFIX_PATH="/path/to/llvm" FEATURE_clang=ON

LLVM/Clang 라이브러리를 설치한 후에는 QDoc 컴파일을 활성화하기 위해 항상 ` FEATURE_clang=ON `를 사용하여 재구성하십시오.