Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[Предыдущая: Файлы проекта qmake ] [ Содержание ] [Следующая: Примечания для платформ ]

[править] Запуск qmake

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

• Опции командной строки
  • Синтаксис
  • Параметры
  • Режимные опции для файла сборки
  • Опции режима проекта

[править] Опции командной строки

[править] Синтаксис

Синтаксис, используемый для запуска qmake, имеет следующую простую форму:

 qmake [mode] [options] files

qmake поддерживает два разных режима управления: по умолчанию, qmake будет использовать описание в файле проекта для создания файлов сборки, но так же возможно использование qmake для создания файлов проекта. Если вы хотите установить детальный режим, вы должны определить это раньше, чем остальные опции. Значение режима может быть одним из следующих:

• -makefile
  выходной файл qmake будет файлом сборки.
• -project
  выходной файл qmake будет файлом проекта.

Следующие опции используются для определения как общих, так и определяющих режим настроек. Опции, которые применяются для режима файла сборки, описаны в разделе Опции режима файла сборки; опции, которые влияют на создание файлов проекта, описаны в разделе Опции файла проекта.

Аргумент files представляет собой список из одного или более файлов проектов, разделенных пробелами.

[править] Параметры

Широкий диапазон опций может быть определен для qmake в командной строке для настройки порядка процесса сборки и для перезаписи стандартных настроек вашей платформы. Следующие базовые опции предоставляют полезную информацию, точно определяют, где qmake запишет выходной файл, и управляют уровнем отладочной информации, которая будет записана в консоль: -help qmake пропустит эти свойства и предоставит некоторую полезную информацию..

• -help
  qmake пропустит эти свойства и предоставит некоторую полезную информацию.
• -o file
  Выходную информацию qmake запишет в file. Если это опция не определена, qmake будет пытаться использовать подходящее имя файла для выходной информации, в зависимости от режима, в котором он запущен.
  Если '-' определено, выходная информация записывается в stdout.
• -d
  qmake будет выводить отладочную информацию.

Для проектов, которым нужна различная сборка для каждой целевой платформы с большим количеством подкаталогов, вы можете запустить qmake с каждой из следующих опций для установки соответствующих платформо-ориентированных переменных в каждом файле проекта: -unix qmake будет запущен в режиме unix.

• -unix
  qmake будет запущен в режиме unix. В этом режиме будет использовано соглашение о Unix именах файлов и директориях, кроме того, будет успешно выполнена проверка для unix (в плане области видимости). Это является режимом по умолчанию для всех *nix.
• -macx
  qmake будет запущен в режиме Mac OS X. В этом режиме будет использовано соглашение о Unix именах файлов и директориях, кроме того, будет успешно выполнена проверка для macx (в плане области видимости). Это является режимом по умолчанию для всех Mac OS X.
• -win32
  qmake будет запущен в режиме win32. В этом режиме будет использовано соглашение о Windows именах файлов и директориях, кроме того, будет успешно выполнена проверка для win32 (в плане области видимости). Это является режимом по умолчанию для Windows .

Шаблон, используемый для проекта, обычно определяется переменной TEMPLATE в файле проекта. Мы можем аннулировать или изменить это, используя следующие опции:

• -t tmpl
  qmake аннулирует любые присвоения переменной TEMPLATE с tmpl, но только после того, как .pro файл будет обработан.
• -tp prefix
  qmake добавит префикс к переменной TEMPLATE.

Уровень предупреждающей информации может быть детально определен, что поможет вам найти проблемы в вашем файле проекта:

• -Wall
  qmake выведет все известные предупреждения.
• -Wnone
  Никаких предупреждений не будет создано qmake.
• -Wparser
  qmake выдаст только ошибки синтаксиса. Это будет предупреждать вас об общих подводных камнях и потенциальных проблемах в синтаксисе вашего файла проекта.
• -Wlogic
  qmake будет предупреждать об общих подводных камнях и потенциальных проблемах в вашем файле проекта. Например, qmake будет сообщать, помещен ли файл в список файлов несколько раз, либо, если файл не найден.

[править] Режимные опции для файла сборки

 qmake -makefile [options] files

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

• -after
  qmake будет обрабатывать присвоения, данные в командной строке, после определения файлов.
• -nocache
  qmake будет игнорировать .qmake.cache файл.
• -nodepend
  qmake не будет создавать какую-либо зависимую информацию.
• -cache file
  qmake будет использовать file в качестве скрытого файла, игнорируя любые другие найденные .qmake.cache файлы.
• -spec spec
  qmake будет использовать spec, как каталог к платформе и информации компилятора, и значении переменной QMAKESPEC будет проигнорировано.

Так же вы можете опустить присвоения для qmake в командной строке; они будут обработаны перед тем, как все файлы будут определены. Пример:

 qmake -makefile -unix -o Makefile "CONFIG+=test" test.pro

Это создает файл сборки из test.pro с форматом Unix для имен каталогов. Как бы ни было, многие из специальных опций не являются необходимыми, так как они определены по умолчанию. Следовательно, строка может быть упрощена для Unix:

 qmake "CONFIG+=test" test.pro

Если вы точны и захотите обрабатывать ваши переменных после определения файлов, то вы можете пропустить опцию -after. Если это установлено, все присвоения в командной строке после опции -after будут отложены до тех пор, пока специальные файлы не будут проанализированы.

[править] Опции режима проекта

 qmake -project [options] files

В режиме проекта qmake создает файл проекта. Так же в этом режиме вы можете указать следующие опции:

• -r
  qmake будет рекурсивно искать предоставленные каталоги.
• -nopwd
  qmake не будет просматривать текущий рабочий каталог для исходного кода, только для использования с опцией files

В этом режиме аргумент files может быть списком файлов или каталогов. Если каталог определен, он будет включен в переменную DEPENDPATH, и соответствующий код из него будет включен в созданный файл проекта. Если файл указан, он будет прикреплен к соответствующей переменной, в зависимости от его расширения, например, .ui файлы добавляются к переменной FORMS, а .cpp файлы добавляются к переменной SOURCES.

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

[Предыдущая: Файлы проекта qmake ] [ Содержание ] [Следующая: Примечания для платформ ]