En esta página

Instalación de Clang para QDoc

QDoc utiliza Clang para analizar archivos C++, así como las firmas de funciones en \fn los comandos. Clang forma parte del proyecto de infraestructura del compilador LLVM. Si vas a compilar QDoc a partir del código fuente, debes instalar Clang 17.0 o una versión posterior.

Opciones de instalación

Qt proporciona paquetes precompilados de LLVM/Clang con soporte oficial, que han sido probados y se utilizan para las compilaciones oficiales de Qt:

Nota: En Windows, los paquetes precompilados de Qt solo son compatibles con las compilaciones de versión «Release».

Gestores de paquetes del 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 bibliotecas del compilador Clang y sus archivos de configuración de CMake. Las dependencias son:

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

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

Linux

LLVM y Clang son paquetes independientes en la mayoría de las distribuciones. Asegúrate de instalar los paquetes (con versión) « -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

Utiliza la fórmula llvm de Homebrew:

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

Nota: El sistema de compilaciónde Qt indica a CMake que busque el archivo ClangConfig.cmake. Asegúrate de que la instalación de tu paquete incluya este archivo. No se pueden utilizar los binarios precompilados de https://releases.llvm.org/download.html, ya que carecen de ciertos componentes que requiere QDoc.

Configuración

Cuando el script «configure» de Qt no pueda localizar las bibliotecas de LLVM/Clang, mostrará instrucciones de instalación específicas para cada plataforma y los comandos de configuración exactos necesarios para tu sistema.

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

  • Establece la variable ` LLVM_INSTALL_DIR `: configure LLVM_INSTALL_DIR="/path/to/llvm" FEATURE_clang=ON
  • O añádelo a CMAKE_PREFIX_PATH: configure CMAKE_PREFIX_PATH="/path/to/llvm" FEATURE_clang=ON

Tras instalar las bibliotecas de LLVM/Clang, vuelve a configurar siempre con « FEATURE_clang=ON » para habilitar la compilación de QDoc.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.