安装 QDoc 的 Clang
QDoc 在解析 C++ 文件以及 \fn 命令中的函数签名时使用 Clang。Clang 是 LLVM 编译器基础设施项目 的一部分。如果您要从源代码构建 QDoc,您必须安装 Clang 15.0 或更高版本。
您可以通过各种渠道获取 Clang
- Qt 提供用于在线安装程序中 Qt 二进制的 预构建 Clang 软件包。这些允许您将 LLVM/Clang 库静态链接,但仅支持 Windows 上的 Release 构建版本。
- Linux 发行版通常提供称为 libclang-dev 或 libclang-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. 的 商标。所有其他商标均为各自所有者的财产。