Installation de Clang pour QDoc

QDoc utilise Clang pour analyser les fichiers C++ ainsi que les signatures de fonctions dans les \fn commandes. Clang fait partie du projet d'infrastructure de compilation LLVM. Si vous comptez compiler QDoc à partir du code source, vous devez installer Clang 17.0 ou une version ultérieure.

Options d’installation

Paquets précompilés de Qt (recommandés)

Qt fournit des paquets LLVM/Clang précompilés officiellement pris en charge, qui ont été testés et sont utilisés pour les versions officielles de Qt :

• Téléchargement à l'adresse : https://download.qt.io/development_releases/prebuilt/libclang/qt/.
• Disponibles pour Windows, macOS et Linux.
• Prise en charge de la liaison statique des bibliothèques LLVM/Clang.
• Version conforme aux exigences de QDoc et à l’intégration continue (CI) de Qt.

Gestionnaires de paquets système

Comme alternative aux paquets précompilés de Qt, vous pouvez installer Clang via les gestionnaires de paquets système. QDoc a spécifiquement besoin des bibliothèques du compilateur Clang et de leurs fichiers de configuration CMake. Les dépendances sont les suivantes :

• llvm-<version> (infrastructure)
• clang-<version> (compilateur et bibliothèques)
• libclang-<version>-dev (en-têtes de développement)
• libclang-cpp<version>-dev (fichiers de développement de l'API C++)

Vous trouverez ci-dessous quelques exemples d'utilisation des gestionnaires de paquets sur les distributions Linux courantes et sur macOS.

Linux

LLVM et Clang sont des paquets distincts dans la plupart des distributions. Veillez à installer les paquets (avec numéro de version) -dev qui fournissent le fichier ClangConfig.cmake.

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

macOS

Utilisez la formule llvm de Homebrew :

• brew install llvm
• Pour les Mac ARM64 : Configurez avec LLVM_INSTALL_DIR="/opt/homebrew/opt/llvm"
• Pour les Mac Intel : configurez avec LLVM_INSTALL_DIR="/usr/local/opt/llvm"

Configuration

Lorsque le script de configuration de Qt ne parvient pas à localiser les bibliothèques LLVM/Clang, il affiche des instructions d’installation spécifiques à la plateforme ainsi que les commandes de configuration exactes requises pour votre système.

Pour spécifier manuellement un emplacement d’installation LLVM personnalisé :

• Définissez la variable d'LLVM_INSTALL_DIR: configure LLVM_INSTALL_DIR="/path/to/llvm" FEATURE_clang=ON
• Ou ajoutez à CMAKE_PREFIX_PATH: configure CMAKE_PREFIX_PATH="/path/to/llvm" FEATURE_clang=ON

Après avoir installé les bibliothèques LLVM/Clang, reconfigurez toujours à l'aide de ` FEATURE_clang=ON ` pour activer la compilation QDoc.