Installieren von Clang für QDoc

QDoc verwendet Clang beim Parsen von C++-Dateien sowie von Funktionssignaturen in \fn-Befehlen. Clang ist Teil des LLVM Compiler Infrastructure Project. Wenn Sie QDoc aus dem Quellcode bauen wollen, müssen Sie Clang 17.0 oder höher installieren.

Installations-Optionen

Vorgefertigte Pakete von Qt (empfohlen)

Qt bietet offiziell unterstützte vorgefertigte LLVM/Clang-Pakete, die getestet und für die offiziellen Qt-Builds verwendet werden:

• Download von: https://download.qt.io/development_releases/prebuilt/libclang/qt/.
• Verfügbar für Windows, macOS und Linux.
• Unterstützt statisches Linken von LLVM/Clang-Bibliotheken.
• Versionsabgleich mit QDoc-Anforderungen und Qt's CI.

System-Paket-Manager

Als Alternative zu den vorgefertigten Paketen von Qt können Sie Clang über System-Paketmanager installieren. QDoc benötigt speziell die Clang-Compiler-Bibliotheken und deren CMake-Konfigurationsdateien. Die Abhängigkeiten sind:

• llvm-<version> (Infrastruktur)
• clang-<version> (Compiler und Bibliotheken)
• libclang-<version>-dev (Entwicklungs-Header)
• libclang-cpp<version>-dev (C++ API Entwicklungsdateien)

Im Folgenden sind einige typische Aufrufe von Paketmanagern auf gängigen Linux-Distributionen und macOS aufgeführt.

Linux

LLVM und Clang sind in den meisten Distributionen separate Pakete. Stellen Sie sicher, dass Sie die (versionierten) -dev Pakete installieren, die die Datei ClangConfig.cmake bereitstellen.

• Debian/Ubuntu: apt install libclang-dev clang libclang-cpp-dev
• Fedora/RHEL: dnf install clang-devel
• Arch Linux: pacman -S clang llvm

macOS

Verwenden Sie die llvm-Formel von Homebrew:

• brew install llvm
• Für ARM64-Macs: Konfigurieren Sie mit LLVM_INSTALL_DIR="/opt/homebrew/opt/llvm"
• Für Intel-Macs: Konfigurieren Sie mit LLVM_INSTALL_DIR="/usr/local/opt/llvm"

Konfiguration

Wenn das configure-Skript von Qt die LLVM/Clang-Bibliotheken nicht finden kann, zeigt es plattformspezifische Installationsanweisungen und die genauen Konfigurationsbefehle an, die für Ihr System erforderlich sind.

Um einen benutzerdefinierten LLVM-Installationsort manuell festzulegen:

• Setzen Sie die Variable LLVM_INSTALL_DIR: configure LLVM_INSTALL_DIR="/path/to/llvm" FEATURE_clang=ON
• Oder fügen Sie zu CMAKE_PREFIX_PATH hinzu: configure CMAKE_PREFIX_PATH="/path/to/llvm" FEATURE_clang=ON

Nach der Installation von LLVM/Clang-Bibliotheken müssen Sie immer mit FEATURE_clang=ON rekonfigurieren, um die QDoc-Kompilierung zu aktivieren.