Installieren von Clang für QDoc

QDoc verwendet Clang beim Parsen von C++-Dateien sowie von Funktionssignaturen in \fn-Befehlen. Clang ist Teil des LLVM Compiler Infrastructure Project. Wenn Sie QDoc aus dem Quellcode bauen wollen, müssen Sie Clang 17.0 oder höher installieren.

Sie können Clang über verschiedene Kanäle beziehen:

  • Qt stellt die vorgefertigten Clang-Pakete, die für die Qt-Binärdateien verwendet werden, im Online-Installer zur Verfügung. Mit diesen können Sie LLVM/Clang-Bibliotheken statisch linken, unterstützen aber nur Release-Builds unter Windows.
  • Linux-Distributionen bieten oft ein Paket namens libclang-dev oder libclang-devel an. Das Build-System von Qt weist CMake an, nach ClangConfig.cmake zu suchen. Stellen Sie also sicher, dass Sie das Paket installieren, das diese Datei bereitstellt, wenn Sie QDoc bauen wollen. Die Ausführung von QDoc erfordert nur libclang.
  • Unter macOS können Sie auch die llvm-Formel von Homebrew verwenden.

Hinweis: Die vorgefertigten Binärdateien von http://releases.llvm.org/download.html können nicht verwendet werden, da ihnen bestimmte von QDoc benötigte Komponenten fehlen.

Wenn Sie Clang an einem eigenen Ort installieren, müssen Sie CMake mitteilen, wo es zu finden ist. Dies können Sie tun, indem Sie Ihren LLVM-Installationspfad mit der Umgebungsvariablen LLVM_INSTALL_DIR bei der Konfiguration von Qt angeben. Alternativ können Sie den Installationspfad zur CMAKE_PREFIX_PATH CMake-Cache-Variable hinzufügen.

© 2025 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.