Установка Clang для QDoc

QDoc использует Clang при разборе файлов C++ и сигнатур функций в командах \fn. Clang является частью проекта LLVM Compiler Infrastructure Project. Поэтому, если вы собираетесь строить QDoc из исходного кода, необходимо сначала установить LLVM 6.0 или более позднюю версию. Требуемые предварительно скомпилированные двоичные файлы можно найти здесь.

Для сборки QDoc на дистрибутивах Linux на основе Debian достаточно установить пакет libclang-dev и его зависимости. Для запуска QDoc требуется пакет libclang.

Автоматическая установка расположения Clang

Система сборки Qt использует инструмент llvm-config для определения расположения LLVM на вашей системе и полагается на то, что путь к llvm-config находится в переменной окружения PATH. llvm-config обычно устанавливается вместе с LLVM и Clang на системах Linux, а также на macOS, если LLVM установлен с помощью Brew.

В Windows двоичные файлы, предоставляемые LLVM, не содержат llvm-config. Вы все равно можете иметь его на своей системе, если вы сами скомпилировали LLVM из исходного кода. Если это так, и вы хотите, чтобы система сборки автоматически нашла Clang, добавьте путь к llvm-config в свою переменную окружения PATH. Например:

C:\> set PATH=%PATH%;C:\[build directory]\bin\Release"

Убедитесь, что задан путь к каталогу вашей сборки LLVM. Исполняемый файл llvm-config расположен в bin\Release или bin\Debug, отражая версию сборки.

Ручная установка расположения Clang

Если llvm-config не находится в вашей переменной окружения PATH или не установлен на вашей системе, вы все равно можете собрать QDoc, вручную установив переменную окружения LLVM_INSTALL_DIR для указания каталога, в котором установлены библиотеки Clang. Этот каталог должен быть верхним каталогом. Например, на системе Linux или macOS с установленным LLVM в /usr/llvm:

$ export LLVM_INSTALL_DIR=/usr/llvm

Дистрибутивы Linux на основе Debian обычно предлагают несколько версий пакетов libclang, таких как libclang-<VERSION>. В этом случае LLVM_INSTALL_DIR должен содержать /usr/lib/clang/<VERSION>.

На системе Windows с установленным LLVM в C:\Program Files\LLVM:

C:\> set LLVM_INSTALL_DIR=C:\Program Files\LLVM