安装 QDoc 的 Clang

QDoc 在解析 C++ 文件以及 \fn 命令中的函数签名时使用 Clang。Clang 是 LLVM 编译器基础设施项目 的一部分。如果您要从源代码构建 QDoc,您必须安装 Clang 15.0 或更高版本。

您可以通过各种渠道获取 Clang

  • Qt 提供用于在线安装程序中 Qt 二进制的 预构建 Clang 软件包。这些允许您将 LLVM/Clang 库静态链接,但仅支持 Windows 上的 Release 构建版本。
  • Linux 发行版通常提供称为 libclang-devlibclang-devel 的软件包。Qt 的构建系统指示 CMake 查找 ClangConfig.cmake,因此如果您想构建 QDoc,请确保安装包含此文件的软件包。运行 QDoc 需要 libclang
  • 在 macOS 上,您还可以使用 Homebrew 的 llvm 公式

注意:来自 http://releases.llvm.org/download.html 的预构建二进制文件不能使用,因为它们缺少 QDoc 所需的某些组件。

如果您在自定义位置安装 Clang,则需要告诉 CMake 它的位置。这可以通过在配置 Qt 时使用 LLVM_INSTALL_DIR 环境变量来指定您的 LLVM 安装路径来完成。或者,您可以将安装路径添加到 CMAKE_PREFIX_PATH CMake 缓存变量中。

© 2024 The Qt Company Ltd. 本说明书所包含的贡献的版权分别属于其所有者。本说明书中提供的文档根据由自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款进行许可。Qt 和相关的标志是芬兰和/或其他国家/地区的 The Qt Company Ltd. 的 商标。所有其他商标均为各自所有者的财产。