Запуск qmake

Поведение qmake можно настроить, указав различные параметры в командной строке при его запуске. Это позволяет усовершенствовать процесс сборки, получить полезную диагностическую информацию и указать целевую платформу для вашего проекта.

Синтаксис команды

Синтаксис запуска qmake имеет следующий простой вид:

qmake [mode] [options] files

Режимы работы

qmake поддерживает два разных режима работы. В стандартном режиме qmake использует информацию из файла проекта для генерации Makefile, но также возможно использовать qmake для генерации файлов проекта. Если вы хотите явно установить режим, вы должны указать его перед всеми другими параметрами. Значение mode может быть одним из следующих двух:

• -makefile Выход qmake будет Makefile.
• -project Выход qmake будет файлом проекта.

  Примечание: Вероятно, созданный файл потребуется отредактировать. Например, добавив переменную QT, чтобы указать, какие модули необходимы для проекта.

Вы можете использовать options для указания как общих, так и режим-специфичных настроек. Параметры, которые применяются только к режиму Makefile, описаны в разделе Параметры режима Makefile, а параметры, влияющие на создание файлов проекта, описаны в разделе Параметры режима проекта.

Файлы

Аргумент files представляет собой список одного или нескольких файлов проекта, разделенных пробелами.

Общие параметры

В командной строке qmake можно указать широкий спектр параметров для настройки процесса сборки и переопределения параметров по умолчанию для вашей платформы. Следующие основные параметры предоставляют помощь по использованию qmake, указывают, куда qmake записывает выходной файл, и контролируют уровень отладочной информации, которая будет выводиться в консоль:

• -help qmake рассмотрит эти особенности и предоставит полезную справку.
• -o file Выход qmake будет направлен в file. Если этот параметр не указан, qmake попытается использовать подходящее имя файла для своего вывода, в зависимости от режима работы. Если указан «-», вывод направляется в стандартный вывод.
• -d qmake выведет отладочную информацию. Указание -d более одного раза увеличивает подробность вывода.

Шаблон для проекта обычно задается переменной TEMPLATE в файле проекта. Вы можете переопределить или изменить это, используя следующие параметры:

• -t tmpl qmake переопределит все заданные TEMPLATE переменные значением tmpl, но только после обработки файла .pro.
• -tp prefix qmake добавит prefix к переменной TEMPLATE.

Уровень сообщений об ошибках можно настроить для помощи в поиске проблем в файле проекта:

• -Wall qmake сообщит обо всех известных ошибках.
• -Wnone Информация об ошибках qmake не будет сгенерирована.
• -Wparser qmake сгенерирует только сообщения об ошибках синтаксического анализа. Это оповестит вас об общих ловушках и потенциальных проблемах в анализе файлов вашего проекта.
• -Wlogic qmake выведет предупреждения об общих ловушках и потенциальных проблемах в вашем файле проекта. Например, qmake сообщит о нескольких повторах файлов в списках и о недостающих файлах.

Параметры режима Makefile

qmake -makefile [options] files

В режиме Makefile qmake сгенерирует Makefile, используемый для сборки проекта. Кроме того, в этом режиме могут быть использованы следующие параметры, влияющие на способ генерации файла проекта:

• -after qmake обработает присваивания, заданные в командной строке, после указанных файлов.
• -nocache qmake проигнорирует файл .qmake.cache.
• -nodepend qmake не будет генерировать информацию о зависимостях.
• -cache file qmake будет использовать file в качестве файла кэша, игнорируя любые другие файлы .qmake.cache.
• -spec spec qmake будет использовать spec как путь к информации о платформе и компиляторе и игнорировать значение QMAKESPEC.

Вы также можете передать qmake присваивания в командной строке. Они обрабатываются до всех указанных файлов. Например, следующая команда генерирует Makefile из test.pro:

qmake -makefile -o Makefile "CONFIG+=test" test.pro

Однако некоторые из указанных параметров могут быть опущены, так как они являются значениями по умолчанию:

qmake "CONFIG+=test" test.pro

Если вы уверены, что хотите обработать свои переменные после указанных файлов, вы можете указать параметр -after. Когда он указан, все присваивания в командной строке после параметра -after будут отложены до обработки указанных файлов.

Параметры режима проекта

qmake -project [options] files

В режиме проекта qmake сгенерирует файл проекта. Кроме того, вы можете указать следующие параметры в этом режиме:

• -r qmake будет рекурсивно просматривать предоставленные каталоги.
• -nopwd qmake не будет искать исходный код в текущем рабочем каталоге. Он будет использовать только указанные files.

В этом режиме аргумент files может быть списком файлов или каталогов. Если указан каталог, он будет включен в переменную DEPENDPATH, и соответствующий код из него будет включен в сгенерированный файл проекта. Если задан файл, он будет добавлен к соответствующей переменной, в зависимости от его расширения. Например, файлы UI добавляются в FORMS, а файлы C++ добавляются в SOURCES.

Вы также можете передавать присваивания в командной строке в этом режиме. При этом эти присваивания будут размещены в конце сгенерированного файла проекта.