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

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