Installation de Clang pour QDoc

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

Options d'installation

Paquets préconstruits de Qt (recommandé)

Qt fournit des paquets LLVM/Clang préconstruits officiellement supportés qui sont testés et utilisés pour les constructions officielles de Qt :

• Télécharger à partir de : https://download.qt.io/development_releases/prebuilt/libclang/qt/.
• Disponible pour Windows, macOS et Linux.
• Prise en charge de la liaison statique des bibliothèques LLVM/Clang.
• Alignement des versions avec les exigences de la QDoc et l'IC de Qt.

Gestionnaires de paquets système

Comme alternative aux paquets préconstruits de Qt, vous pouvez installer Clang par le biais des gestionnaires de paquets du 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++)

La liste suivante énumère quelques invocations typiques de gestionnaires de paquets sur les distributions Linux et macOS les plus courantes.

Linux

LLVM et Clang sont des paquets distincts dans la plupart des distributions. Assurez-vous d'installer les paquets (versionnés) -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 Macs ARM64 : Configurer avec LLVM_INSTALL_DIR="/opt/homebrew/opt/llvm"
• Pour les Mac Intel : Configurer avec LLVM_INSTALL_DIR="/usr/local/opt/llvm"

Configuration

Lorsque le script configure de Qt Location ne parvient pas à localiser les bibliothèques LLVM/Clang, il affiche des conseils d'installation spécifiques à la plate-forme et les commandes de configuration exactes nécessaires pour votre système.

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

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

Après avoir installé les bibliothèques LLVM/Clang, reconfigurez toujours votre système avec FEATURE_clang=ON pour permettre la compilation de QDoc.