Instalación de Clang para QDoc

QDoc usa Clang cuando analiza archivos C++ así como firmas de funciones en comandos \fn comandos. Clang forma parte del proyecto LLVM Compiler Infrastructure. Si vas a compilar QDoc desde el código fuente, debes instalar Clang 17.0 o posterior.

Opciones de instalación

Paquetes precompilados de Qt (recomendado)

Qt proporciona paquetes precompilados LLVM/Clang oficialmente soportados que son probados y usados para las compilaciones oficiales de Qt:

• Descarga desde: https://download.qt.io/development_releases/prebuilt/libclang/qt/.
• Disponible para Windows, macOS y Linux.
• Soporta la vinculación estática de las bibliotecas LLVM/Clang.
• Alineación de versiones con los requisitos de QDoc y el CI de Qt.

Gestores de paquetes de sistema

Como alternativa a los paquetes precompilados de Qt, puedes instalar Clang a través de los gestores de paquetes del sistema. QDoc necesita específicamente las librerías del compilador Clang y sus archivos de configuración CMake. Las dependencias son:

• llvm-<version> (infraestructura)
• clang-<version> (compilador y bibliotecas)
• libclang-<version>-dev (cabeceras de desarrollo)
• libclang-cpp<version>-dev (archivos de desarrollo de la API de C++)

A continuación se enumeran algunas invocaciones típicas de los gestores de paquetes en distribuciones populares de Linux y macOS.

Linux

LLVM y Clang son paquetes separados en la mayoría de las distribuciones. Asegúrate de instalar los paquetes (versionados) -dev que proporcionan el archivo 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

Utilice la fórmula llvm de Homebrew:

• brew install llvm
• Para Macs ARM64: Configurar con LLVM_INSTALL_DIR="/opt/homebrew/opt/llvm"
• Para Macs Intel: Configurar con LLVM_INSTALL_DIR="/usr/local/opt/llvm"

Configuración

Cuando el script configure de Qt no puede localizar las librerías LLVM/Clang, mostrará una guía de instalación específica de la plataforma y los comandos de configuración exactos necesarios para tu sistema.

Para especificar manualmente una ubicación de instalación de LLVM personalizada:

• Establezca la variable LLVM_INSTALL_DIR: configure LLVM_INSTALL_DIR="/path/to/llvm" FEATURE_clang=ON
• O añada a CMAKE_PREFIX_PATH: configure CMAKE_PREFIX_PATH="/path/to/llvm" FEATURE_clang=ON

Después de instalar las librerías LLVM/Clang, reconfigure siempre con FEATURE_clang=ON para habilitar la compilación de QDoc.