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

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