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

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