Запуск 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.

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