Запуск qmake

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

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

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

qmake [mode] [options] files

Примечание: Если Qt был установлен с помощью менеджера пакетов, бинарный файл может быть qmake6.

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

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 попытается использовать подходящее имя файла для своего вывода, в зависимости от режима его работы. Если указан '-', вывод направляется в stdout.
• -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.

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