Clang für QDoc installieren

QDoc verwendet Clang zum Parsen von C++-Dateien sowie von Funktionssignaturen in \fn Befehlen. Clang ist Teil des LLVM-Compiler-Infrastruktur-Projekts. Wenn Sie QDoc aus dem Quellcode kompilieren möchten, müssen Sie Clang 17.0 oder höher installieren.

Installationsoptionen

Vorkompilierte Pakete von Qt (empfohlen)

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

• Download unter: https://download.qt.io/development_releases/prebuilt/libclang/qt/.
• Verfügbar für Windows, macOS und Linux.
• Unterstützen die statische Verknüpfung von LLVM/Clang-Bibliotheken.
• Versionsanpassung an die QDoc-Anforderungen und die CI von Qt.

System-Paketmanager

Als Alternative zu den vorgefertigten Paketen von Qt können Sie Clang über die systemeigenen Paketmanager installieren. QDoc benötigt insbesondere 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 Befehle für Paketmanager auf gängigen Linux-Distributionen und unter macOS aufgeführt.

Linux

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

• 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 sowie die für Ihr System erforderlichen Konfigurationsbefehle an.

So geben Sie manuell einen benutzerdefinierten Installationspfad für LLVM an:

• 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

Führen Sie nach der Installation der LLVM/Clang-Bibliotheken immer eine Neukonfiguration mit ` FEATURE_clang=ON ` durch, um die QDoc-Kompilierung zu aktivieren.