Переменные

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

Платформенно-специфические переменные следуют шаблону именования переменных, которые они расширяют или изменяют, но включают в своё имя имя соответствующей платформы. Например, makespec может использовать QMAKE_LIBS для указания списка библиотек, от которых каждый проект должен зависеть, а QMAKE_LIBS_X11 будет использоваться для расширения этого списка.

ANDROID_ABIS

Примечание: Эта переменная применяется только к целям Android.

Указывает список целевых ABIs Android. Допустимые значения: armeabi-v7a, arm64-v8a, x86, x86_64.

Вы можете указать ABIs в качестве аргумента qmake:

qmake ANDROID_ABIS="armeabi-v7a arm64-v8a"

Примечание: Можно использовать эту переменную внутри файла *.pro, однако это не рекомендуется, так как это переопределит любые ABIs, указанные в командной строке qmake.

ANDROID_API_VERSION

Примечание: Эта переменная применяется только к целям Android.

Указывает номер уровня API Android. Для получения дополнительной информации см. Номера сборок Android.

ANDROID_APPLICATION_ARGUMENTS

Примечание: Эта переменная применяется только к целям Android.

Указывает дополнительные аргументы командной строки для приложения Android, используя AndroidManifest.xml со тегом "android.app.arguments". Это строка аргументов:

ANDROID_APPLICATION_ARGUMENTS = "arg1 arg2 arg3"

ANDROID_BUNDLED_JAR_DEPENDENCIES

Примечание: Эта переменная применяется только к модулям Android.

Это полезно при написании модуля Qt. Она указывает список предварительно скомпонованных зависимостей, используемых модулем в формате .jar, например:

ANDROID_BUNDLED_JAR_DEPENDENCIES += jar/Qt6Android.jar

ANDROID_DEPLOYMENT_DEPENDENCIES

Примечание: Эта переменная применяется только к целям Android.

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

Примечание: Включаются только файлы Qt, указанные в этой переменной. Невозможность включения всех необходимых файлов может привести к ошибкам. Также важно убедиться, что файлы перечислены в правильном порядке загрузки. Эта переменная позволяет полностью переопределить автоматическое обнаружение, поэтому, если библиотека указана до ее зависимостей, она может не загрузиться на некоторых устройствах.

ANDROID_DEPLOYMENT_SETTINGS_FILE

Примечание: Эта переменная применяется только к целям Android.

Указывает путь к файлу android-deployment-settings.json, необходимый для androiddeployqt и androidtestrunner. Это переопределяет путь к файлу настроек, создаваемому qmake, поэтому необходимо убедиться, что вы предоставляете действительный файл настроек.

ANDROID_EXTRA_LIBS

Примечание: Эта переменная применяется только к целям Android.

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

Для включения внешних библиотек для нескольких ABIs, где каждый ABI имеет свою собственную папку, используйте следующее:

for (abi, ANDROID_ABIS): ANDROID_EXTRA_LIBS += $$PWD/$${abi}/library_name.so

В противном случае, если ABI включен в имя библиотеки, используйте следующее:

for (abi, ANDROID_ABIS): ANDROID_EXTRA_LIBS += $$PWD/library_name_$${abi}.so

ANDROID_EXTRA_PLUGINS

Примечание: Эта переменная применяется только к целям Android.

Указывает путь к C++ плагинам или ресурсам, которые ваше приложение должно объединить, но которые не могут быть доставлены через систему ресурсов, такие как QML плагины. С помощью этой переменной androiddeployqt гарантирует, что все будет правильно упаковано и развернуто.

ANDROID_EXTRA_PLUGINS должен указывать на каталог, где построены дополнительные плагины. Кроме того, структура каталога сборки должна соответствовать соглашению об именовании плагинов Qt, т.е. plugins/<имя плагина>.

Библиотеки плагинов должны иметь формат имен libplugins_<тип>_<имя>_<abi>.so. Для этого файл pro плагина можно определить следующим образом:

TEMPLATE = lib
CONFIG += plugin

PLUGIN_TYPE = imageformats
DESTDIR = $$top_builddir/plugins/myplugin
TARGET = $$qt5LibraryTarget(myplugin, "plugins/$$PLUGIN_TYPE/")

с top_builddir, определённым в .qmake.conf как:

top_builddir=$$shadowed($$PWD)

Это обеспечит правильное изменение имени библиотеки плагина (plugins/myplugin/libplugins_imageformats_myplugin_armeabi-v7a.so).

Затем, предполагая, что дополнительный плагин формата изображения myplugin построен как $$DESTDIR/plugins/myplugin/, следующее обеспечивает его правильную упаковку:

ANDROID_EXTRA_PLUGINS += $$top_builddir/plugins

ANDROID_FEATURES

Примечание: Эта переменная применяется только к модулям Android.

Указывает список функций модуля:

ANDROID_FEATURES += android.hardware.location.gps

Для получения дополнительной информации см. Документацию Android <uses-feature>.

ANDROID_LIB_DEPENDENCIES

Примечание: Эта переменная применяется только к модулям Android.

Это полезно при написании Qt модуля. Он указывает список предварительно скомпонованных зависимостей, используемых модулем, например:

ANDROID_LIB_DEPENDENCIES += \
    plugins/libplugins_platforms_qtforandroid.so

ANDROID_MIN_SDK_VERSION

Примечание: Эта переменная применяется только к целям Android.

Указывает минимальный уровень API Android для проекта. По умолчанию эта переменная установлена на уровень API 23.

ANDROID_PACKAGE_SOURCE_DIR

Примечание: Эта переменная применяется только к целям Android.

Указывает путь к шаблону пакета Android. Шаблон пакета Android содержит:

• файл AndroidManifest.xml
• файл build.gradle и другие скрипты Gradle
• файл res/values/libs.xml

Путь, указанный этой переменной, может содержать пользовательские классы Java в каталоге src. По умолчанию инструмент androiddeployqt копирует шаблон приложения из пути установки Qt для Android в каталог сборки вашего проекта, затем копирует содержимое пути, указанного этой переменной, поверх него, перезаписывая все существующие файлы. Например, вы можете создать пользовательский AndroidManifest.xml для вашего приложения, затем поместите его непосредственно в каталог, указанный этой переменной.

ANDROID_PERMISSIONS

Примечание: Эта переменная применяется только к модулям Android.

Указывает список разрешений модуля:

ANDROID_PERMISSIONS += android.permission.ACCESS_FINE_LOCATION

Для получения дополнительной информации см. Документацию Android <uses-permission>.

ANDROID_TARGET_SDK_VERSION

Примечание: Эта переменная применяется только к целям Android.

Указывает целевой уровень API Android для проекта. По умолчанию эта переменная установлена на уровень API 29.

ANDROID_VERSION_CODE

Примечание: Эта переменная применяется только к целям Android.

Указывает номер версии приложения. Для получения дополнительной информации см. Версионирование приложений Android.

ANDROID_VERSION_NAME

Примечание: Эта переменная применяется только к целям Android.

Указывает версию приложения в читаемом человеком виде. Для получения дополнительной информации см. Версионирование приложений Android.

CONFIG

Указывает конфигурацию проекта и параметры компилятора. Значения распознаются qmake и имеют специальное значение.

Следующие CONFIG значения управляют флагами компилятора и компоновщика:

При использовании опции debug_and_release (по умолчанию в Windows), проект будет обработан трижды: один раз для создания «мета» Makefile, и дважды для создания Makefile.Debug и Makefile.Release.

Во время последующих проходов build_pass и соответствующие debug или release опции добавляются к CONFIG. Это позволяет выполнять задачи, специфичные для сборки. Например:

build_pass:CONFIG(debug, debug|release) {
    unix: TARGET = $$join(TARGET,,,_debug)
    else: TARGET = $$join(TARGET,,,d)
}

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

«Мета» Makefile делает подсборки вызываемыми через цели debug и release, а комбинированную сборку — через цель all. Когда используется опция build_all CONFIG, комбинированная сборка является значением по умолчанию. В противном случае, последняя указанная опция CONFIG из набора (debug, release) определяет значение по умолчанию. В этом случае вы можете явно вызвать цель all для одновременной сборки обоих конфигураций:

make all

Примечание: Детали немного отличаются при создании проектов Visual Studio и Xcode.

При линковке библиотеки, qmake полагается на базовые платформы, чтобы знать, к каким другим библиотекам эта библиотека подключается. Однако, если происходит статическая линковка, qmake не получит эту информацию, если не использовать следующие CONFIG опции:

Примечание: Опция create_prl необходима при создании статической библиотеки, а link_prl — при использовании статической библиотеки.

Следующие опции определяют тип приложения или библиотеки:

Эти параметры определяют специфические особенности только для Windows:

См. Заметки к платформе для получения дополнительной информации об опциях встраивания файлов манифеста.

Следующие параметры действуют только в macOS:

Процесс сборки пакетов также зависит от содержимого переменной QMAKE_BUNDLE_DATA.

Следующие параметры действуют только на платформах Linux/Unix:

При разрешении областей также проверяется переменная CONFIG. Вы можете присвоить ей любое значение.

Например:

CONFIG += console newstuff
...
newstuff {
    SOURCES += new.cpp
    HEADERS += new.h
}

DEFINES

qmake добавляет значения этой переменной в качестве макросов препроцессора компилятора C (-D опция).

Например:

DEFINES += USE_MY_STUFF

DEFINES_DEBUG

Устанавливает макросы препроцессора для отладочной конфигурации. Значения этой переменной добавляются к DEFINES после загрузки проекта. Эта переменная обычно задается в qmake.conf и редко требует модификации.

Эта переменная была введена в Qt 5.13.2.

DEFINES_RELEASE

Устанавливает макросы препроцессора для релизной конфигурации. Значения этой переменной добавляются к DEFINES после загрузки проекта. Эта переменная обычно задается в qmake.conf и редко требует модификации.

Примечание: Для MSVC mkspecs, эта переменная по умолчанию содержит значение NDEBUG.

Эта переменная была введена в Qt 5.13.2.

DEF_FILE

Примечание: Эта переменная используется только в Windows при использовании шаблона app.

Указывает файл .def для включения в проект.

DEPENDPATH

Указывает список каталогов для сканирования qmake для разрешения зависимостей. Эта переменная используется, когда qmake просматривает заголовочные файлы, которые вы #include в вашем исходном коде.

DESTDIR

Указывает, куда поместить файл target.

Например:

DESTDIR = ../../lib

Примечание: Список поддерживаемых символов может зависеть от используемого инструмента сборки. В частности, скобки не работают с make.

DISTFILES

Указывает список файлов, которые следует включить в цель dist. Эта функция поддерживается только спецификациями UnixMake.

Например:

DISTFILES += ../program.txt

DLLDESTDIR

Примечание: Этот параметр применяется только к целевым объектам Windows.

Указывает, куда скопировать dll target.

EXTRA_TRANSLATIONS

Указывает список файлов переводов (.ts), содержащих переводы текста пользовательского интерфейса на языки, отличные от родного.

В отличие от TRANSLATIONS, файлы переводов в EXTRA_TRANSLATIONS будут обрабатываться только lrelease, а не lupdate.

Вы можете использовать CONFIG += lrelease для автоматической компиляции файлов во время сборки и CONFIG += lrelease embed_translations, чтобы сделать их доступными в Системе ресурсов Qt.

См. Руководство по Qt Linguist для получения дополнительной информации об интернационализации (i18n) и локализации (l10n) с помощью Qt.

FORMS

Указывает файлы интерфейса (см. Руководство по Qt Designer), которые должны быть обработаны uic перед компиляцией. Все зависимости, заголовочные файлы и исходные файлы, необходимые для построения этих файлов интерфейса, будут автоматически добавлены в проект.

Например:

FORMS = mydialog.ui \
    mywidget.ui \
        myconfig.ui

GUID

Указывает GUID, который устанавливается внутри файла .vcproj. GUID обычно определяется случайным образом. Однако, если вам нужен фиксированный GUID, его можно установить с помощью этой переменной.

Эта переменная специфична только для файлов .vcproj и игнорируется в противном случае.

HEADERS

Определяет заголовочные файлы для проекта.

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

Например:

HEADERS = myclass.h \
          login.h \
          mainwindow.h

См. также SOURCES.

ICON

Эта переменная используется только в macOS для установки значка приложения. Для получения дополнительной информации см. документацию по значку приложения.

IDLSOURCES

Эта переменная используется только в Windows для генерации проекта Visual Studio, чтобы поместить указанные файлы в папку «Сгенерированные файлы».

INCLUDEPATH

Указывает каталоги #include, которые следует искать при компиляции проекта.

Например:

INCLUDEPATH = c:/msdev/include d:/stl/include

Чтобы указать путь, содержащий пробелы, укажите путь в кавычках, используя метод, описанный в Пробелы.

win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"

INSTALLS

Указывает список ресурсов, которые будут установлены при выполнении make install или аналогичной процедуры установки. Каждый элемент в списке обычно определяется атрибутами, которые предоставляют информацию о том, куда он будет установлен.

Например, следующее определение target.path описывает, куда будет установлен целевой объект сборки, а назначение INSTALLS добавляет целевой объект сборки в список существующих ресурсов для установки:

target.path += $$[QT_INSTALL_PLUGINS]/imageformats
INSTALLS += target

INSTALLS имеет член .CONFIG , который может принимать несколько значений:

Для получения дополнительной информации см. Установка файлов.

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

JAVA_HOME

Примечание: Эта переменная полезна только для целей Android.

Указывает путь к установке JDK/OpenJDK, используемый для сборки проекта.

LEXIMPLS

Указывает список файлов реализации Lex. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

LEXOBJECTS

Указывает имена промежуточных файлов объектов Lex. Значение этой переменной обычно обрабатывается qmake и редко требует изменения.

LEXSOURCES

Указывает список файлов исходного кода Lex. Все зависимости, заголовки и исходные файлы автоматически добавляются в проект для сборки этих файлов lex.

Например:

LEXSOURCES = lexer.l

LIBS

Указывает список библиотек, которые необходимо связать с проектом. Если вы используете Unix-флаги -l (библиотека) и -L (путь к библиотеке), qmake корректно обрабатывает библиотеки в Windows (то есть передаёт полный путь к библиотеке компоновщику). Библиотека должна существовать для того, чтобы qmake нашёл каталог, где находится -l lib.

Например:

unix:LIBS += -L/usr/local/lib -lmath
win32:LIBS += c:/mylibs/math.lib

Чтобы указать путь, содержащий пробелы, заключите путь в кавычки, используя метод, описанный в Пробелы.

win32:LIBS += "C:/mylibs/extra libs/extra.lib"
unix:LIBS += "-L/home/user/extra libs" -lextra

По умолчанию список библиотек, хранящихся в LIBS, сводится к списку уникальных имён перед использованием. Чтобы изменить это поведение, добавьте опцию no_lflags_merge к переменной CONFIG:

CONFIG += no_lflags_merge

LIBS_PRIVATE

Указывает список библиотек, которые необходимо связать с проектом в частном порядке. Поведение этой переменной идентично LIBS, за исключением того, что проекты с динамическими библиотеками, созданные для Unix, не отображают эти зависимости в их интерфейсе связывания.

Это означает, что если проект C зависит от библиотеки B, которая в свою очередь зависит от библиотеки A в частном порядке, но C также хочет использовать символы из A напрямую, ему нужно явно ссылаться на A. Другими словами, библиотеки, связанные в частном порядке, не передаются транзитивно во время сборки.

LITERAL_HASH

Эта переменная используется всякий раз, когда в объявлении переменной нужен символ хеша (#), возможно, как часть имени файла или в строке, передаваемой внешнему приложению.

Например:

# To include a literal hash character, use the $$LITERAL_HASH variable:
urlPieces = http://doc.qt.io/qt-5/qtextdocument.html pageCount
message($$join(urlPieces, $$LITERAL_HASH))

Используя LITERAL_HASH, символ # может использоваться для построения URL для функции message() для вывода в консоль.

MAKEFILE

Указывает имя сгенерированного файла Makefile. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

MAKEFILE_GENERATOR

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

MSVCPROJ_*

Эти переменные обрабатываются qmake и не должны изменяться или использоваться.

MOC_DIR

Указывает каталог, в котором должны размещаться все промежуточные файлы moc.

Например:

unix:MOC_DIR = ../myproject/tmp
win32:MOC_DIR = c:/myproject/tmp

OBJECTIVE_HEADERS

Определяет заголовочные файлы Objective-C++ для проекта.

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

Это аналогично переменной HEADERS, но позволит скомпилировать сгенерированные файлы moc с помощью компилятора Objective-C++.

См. также OBJECTIVE_SOURCES.

OBJECTIVE_SOURCES

Указывает имена всех файлов исходного кода Objective-C/C++ в проекте.

Эта переменная устарела; файлы Objective-C/C++ (.m и .mm) теперь можно добавить в переменную SOURCES.

См. также OBJECTIVE_HEADERS.

OBJECTS

Эта переменная автоматически заполняется из переменной SOURCES. Расширение каждого файла исходного кода заменяется на .o (Unix) или .obj (Win32). Вы можете добавить объекты в список.

OBJECTS_DIR

Указывает каталог, в котором должны размещаться все промежуточные объекты.

Например:

unix:OBJECTS_DIR = ../myproject/tmp
win32:OBJECTS_DIR = c:/myproject/tmp

POST_TARGETDEPS

Перечисляет библиотеки, от которых зависит целевой объект target. Некоторые бэкэнды, такие как генераторы файлов проектов Visual Studio и Xcode, не поддерживают эту переменную. Как правило, эта переменная поддерживается внутренне этими инструментами сборки, и она полезна для явного перечисления зависимых статических библиотек.

Этот список размещается после всех встроенных (и $$PRE_TARGETDEPS) зависимостей.

PRE_TARGETDEPS

Перечисляет библиотеки, от которых зависит целевой объект target. Некоторые бэкэнды, такие как генераторы файлов проектов Visual Studio и Xcode, не поддерживают эту переменную. Как правило, эта переменная поддерживается внутренне этими инструментами сборки, и она полезна для явного перечисления зависимых статических библиотек.

Этот список размещается перед всеми встроенными зависимостями.

PRECOMPILED_HEADER

Указывает заголовочный файл для создания предварительно скомпилированного заголовочного файла, чтобы ускорить компиляцию проекта. Предварительно скомпилированные заголовки в настоящее время поддерживаются только на некоторых платформах (Windows — все типы проектов MSVC, Apple — Xcode, Makefile, Unix — gcc 3.3 и выше).

PWD

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

См. также _PRO_FILE_PWD_.

Примечание: Не пытайтесь перезаписать значение этой переменной.

OUT_PWD

Указывает полный путь к каталогу, куда qmake помещает сгенерированный Makefile.

Примечание: Не пытайтесь перезаписать значение этой переменной.

QM_FILES_RESOURCE_PREFIX

Указывает каталог в системе ресурсов, где файлы .qm будут доступны с помощью CONFIG += embed_translations.

По умолчанию :/i18n/.

QM_FILES_INSTALL_PATH

Указывает целевой каталог, в который будут установлены файлы .qm, сгенерированные с помощью CONFIG += lrelease. Не имеет никакого эффекта, если установлен CONFIG += embed_translations.

QML_IMPORT_PATH

Эта переменная используется только в Qt Creator. Подробности см. в Qt Creator: Использование QML-модулей с плагинами.

QMAKE

Указывает имя программы qmake и размещается в сгенерированных файлах Makefile. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKESPEC

Системная переменная, содержащая полный путь к конфигурации qmake, используемой при генерации файлов Makefile. Значение переменной вычисляется автоматически.

Примечание: Не пытайтесь перезаписать значение этой переменной.

QMAKE_AR_CMD

Примечание: Эта переменная используется только на платформах Unix.

Указывает команду, которая будет выполнена при создании динамической библиотеки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_BUNDLE_DATA

Примечание: Эта переменная используется только на macOS, iOS, tvOS и watchOS.

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

Например, следующие строки добавляют path/to/header_one.h и path/to/header_two.h в группу, содержащую информацию о заголовках, предоставляемых с фреймворком:

FRAMEWORK_HEADERS.version = Versions
FRAMEWORK_HEADERS.files = path/to/header_one.h path/to/header_two.h
FRAMEWORK_HEADERS.path = Headers
QMAKE_BUNDLE_DATA += FRAMEWORK_HEADERS

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

Пакеты библиотек создаются, когда опция lib_bundle добавляется к переменной CONFIG.

См. Примечания к платформе для получения дополнительной информации о создании пакетов библиотек.

QMAKE_BUNDLE_EXTENSION

Примечание: Эта переменная используется только на macOS, iOS, tvOS и watchOS.

Указывает расширение, которое будет использоваться для пакетов библиотек. Это позволяет создавать фреймворки с пользовательскими расширениями вместо стандартного .framework расширения имени каталога.

Например, следующее определение приведет к созданию фреймворка с расширением .myframework.

QMAKE_BUNDLE_EXTENSION = .myframework

QMAKE_CC

Указывает C-компилятор, который будет использоваться при сборке проектов, содержащих исходный код C. Достаточно указать только имя исполняемого файла компилятора, при условии, что он находится в пути, указанном в переменной PATH при обработке файла Makefile.

QMAKE_CFLAGS

Указывает флаги компилятора C для сборки проекта. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения. Флаги, специфичные для режимов отладки и релизного билда, можно настроить, изменив переменные QMAKE_CFLAGS_DEBUG и QMAKE_CFLAGS_RELEASE соответственно.

QMAKE_CFLAGS_DEBUG

Указывает флаги компилятора C для сборки в режиме отладки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CFLAGS_RELEASE

Указывает флаги компилятора C для релизного билда. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO

Указывает флаги компилятора C для релизного билда, где force_debug_info установлено в CONFIG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CFLAGS_SHLIB

Примечание: Эта переменная используется только на платформах Unix.

Указывает флаги компилятора для создания динамической библиотеки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CFLAGS_THREAD

Указывает флаги компилятора для создания многопоточного приложения. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CFLAGS_WARN_OFF

Эта переменная используется только при установке опции warn_off CONFIG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CFLAGS_WARN_ON

Эта переменная используется только при установке опции warn_on CONFIG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CLEAN

Указывает список сгенерированных файлов (например, от moc и uic) и файлов объектных модулей, которые должны быть удалены make clean.

QMAKE_CXX

Указывает компилятор C++, который будет использоваться при сборке проектов, содержащих код на C++. Нужно указать только имя исполняемого файла компилятора, при условии, что он находится в пути, указанном в переменной PATH при обработке Makefile.

QMAKE_CXXFLAGS

Указывает флаги компилятора C++ для сборки проекта. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения. Флаги, специфичные для режимов отладки и релизного билда, можно настроить, изменив переменные QMAKE_CXXFLAGS_DEBUG и QMAKE_CXXFLAGS_RELEASE соответственно.

QMAKE_CXXFLAGS_DEBUG

Указывает флаги компилятора C++ для сборки в режиме отладки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CXXFLAGS_RELEASE

Указывает флаги компилятора C++ для релизного билда. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CXXFLAGS_RELEASE_WITH_DEBUGINFO

Указывает флаги компилятора C++ для релизного билда, где force_debug_info установлено в CONFIG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CXXFLAGS_SHLIB

Указывает флаги компилятора C++ для создания динамической библиотеки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CXXFLAGS_THREAD

Указывает флаги компилятора C++ для создания многопоточного приложения. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CXXFLAGS_WARN_OFF

Указывает флаги компилятора C++ для отключения предупреждений компилятора. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_CXXFLAGS_WARN_ON

Указывает флаги компилятора C++ для включения предупреждений компилятора. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_DEVELOPMENT_TEAM

Примечание: Эта переменная используется только на macOS, iOS, tvOS и watchOS.

Идентификатор команды разработчиков, используемый для подписи сертификатов и профилей.

QMAKE_DISTCLEAN

Указывает список файлов, которые должны быть удалены make distclean.

QMAKE_EXTENSION_SHLIB

Содержит расширение для динамических библиотек. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

Примечание: Платформенно-специфические переменные, которые меняют расширение, перезаписывают содержимое этой переменной.

QMAKE_EXTENSION_STATICLIB

Содержит расширение для статических библиотек. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_EXT_MOC

Содержит расширение, используемое для включенных файлов moc.

См. также Расширения файлов.

QMAKE_EXT_UI

Содержит расширение, используемое для файлов пользовательского интерфейса Qt Designer.

См. также Расширения файлов.

QMAKE_EXT_PRL

Содержит расширение, используемое для созданных файлов PRL.

См. также Расширения файлов, Зависимости библиотек.

QMAKE_EXT_LEX

Содержит расширение, используемое для файлов, переданных в Lex.

См. также Расширения файлов, LEXSOURCES.

QMAKE_EXT_YACC

Содержит расширение, используемое для файлов, переданных в Yacc.

См. также Расширения файлов, YACCSOURCES.

QMAKE_EXT_OBJ

Содержит расширение, используемое для сгенерированных объектных файлов.

См. также Расширения файлов.

QMAKE_EXT_CPP

Содержит суффиксы для файлов, которые должны интерпретироваться как исходные файлы C++.

См. также Расширения файлов.

QMAKE_EXT_H

Содержит суффиксы для файлов, которые должны интерпретироваться как заголовочные файлы C.

См. также Расширения файлов.

QMAKE_EXTRA_COMPILERS

Указывает список дополнительных компиляторов или препроцессоров.

См. также Добавление компиляторов.

QMAKE_EXTRA_TARGETS

Указывает список дополнительных целей qmake.

См. также Добавление пользовательских целей.

QMAKE_FAILED_REQUIREMENTS

Содержит список неудовлетворённых требований. Значение этой переменной устанавливается qmake и не может быть изменено.

См. также requires() и REQUIRES.

QMAKE_FRAMEWORK_BUNDLE_NAME

Примечание: Эта переменная используется только на macOS, iOS, tvOS и watchOS.

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

По умолчанию эта переменная содержит то же значение, что и переменная TARGET.

См. Создание фреймворков для получения дополнительной информации о создании фреймворков и пакетов библиотек.

QMAKE_FRAMEWORK_VERSION

Примечание: Эта переменная используется только на macOS, iOS, tvOS и watchOS.

Для проектов, где целевой сборкой является фреймворк macOS, iOS, tvOS или watchOS, эта переменная используется для указания номера версии, который будет применён к созданному фреймворку.

По умолчанию эта переменная содержит то же значение, что и переменная VERSION.

См. Создание фреймворков для получения дополнительной информации о создании фреймворков.

QMAKE_HOST

Предоставляет информацию о хост-машине, на которой выполняется qmake. Например, вы можете получить архитектуру хост-машины из QMAKE_HOST.arch.

win32-g++:contains(QMAKE_HOST.arch, x86_64):{
    message("Host is 64bit")
    ...
}

QMAKE_INCDIR

Указывает список путей к системным заголовочным файлам, которые добавляются к INCLUDEPATH. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_INCDIR_EGL

Указывает расположение заголовочных файлов EGL, которые будут добавлены к INCLUDEPATH при сборке целевого объекта с поддержкой OpenGL/ES или OpenVG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_INCDIR_OPENGL

Указывает расположение заголовочных файлов OpenGL, которые будут добавлены в INCLUDEPATH при построении целевого объекта с поддержкой OpenGL. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

Если реализация OpenGL использует EGL (большинство систем OpenGL/ES), то также может потребоваться установить QMAKE_INCDIR_EGL.

QMAKE_INCDIR_OPENGL_ES2

Эта переменная указывает расположение заголовочных файлов OpenGL, которые будут добавлены в INCLUDEPATH при построении целевого объекта с поддержкой OpenGL ES 2.

Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

Если реализация OpenGL использует EGL (большинство систем OpenGL/ES), то также может потребоваться установить QMAKE_INCDIR_EGL.

QMAKE_INCDIR_OPENVG

Указывает расположение заголовочных файлов OpenVG, которые будут добавлены в INCLUDEPATH при построении целевого объекта с поддержкой OpenVG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

Если реализация OpenVG использует EGL, то также может потребоваться установить QMAKE_INCDIR_EGL.

QMAKE_INCDIR_X11

Примечание: Эта переменная используется только на платформах Unix.

Указывает расположение путей к заголовочным файлам X11, которые будут добавлены в INCLUDEPATH при построении целевого объекта X11. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_INFO_PLIST

Примечание: Эта переменная используется только на платформах macOS, iOS, tvOS и watchOS.

Указывает имя файла файла свойств, .plist, который вы хотите включить в пакет приложения macOS, iOS, tvOS и watchOS.

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

Примечание: При использовании генератора Xcode вышеуказанные заполнительные элементы в стиле ${var} непосредственно заменяются системой построения Xcode и не обрабатываются qmake. Заполнительные элементы в стиле @var@ работают только с генераторами Makefile qmake, а не с генератором Xcode.

Если построение выполняется для iOS, и файл .plist содержит ключ NSPhotoLibraryUsageDescription, qmake включит дополнительный плагин в сборку, который добавляет поддержку доступа к фотографиям (например, к QFile/QFileDialog). Дополнительную информацию об этом ключе см. в документации Info.plist от Apple.

Примечание: В большинстве случаев значение по умолчанию Info.plist является достаточным.

QMAKE_IOS_DEPLOYMENT_TARGET

Примечание: Эта переменная используется только на платформе iOS.

Указывает минимальную версию iOS, которую поддерживает приложение.

Для получения дополнительной информации см. Выражение поддерживаемых версий iOS.

QMAKE_IOS_LAUNCH_SCREEN

Примечание: Эта переменная используется только на платформе iOS.

Указывает заставку запуска, используемую приложением. Если она не установлена, используется заставка запуска по умолчанию.

QMAKE_LFLAGS

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

QMAKE_LFLAGS_CONSOLE

Примечание: Эта переменная используется только в Windows.

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

QMAKE_LFLAGS_DEBUG

Указывает флаги компоновщика для отладочных сборок. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_PLUGIN

Указывает флаги компоновщика для построения плагинов. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_RPATH

Примечание: Эта переменная используется только на платформах Unix.

Указывает флаги компоновщика, необходимые для использования значений из QMAKE_RPATHDIR.

Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_REL_RPATH

Указывает флаги компоновщика, необходимые для включения относительных путей в QMAKE_RPATHDIR.

Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_REL_RPATH_BASE

Указывает строку, которую динамический компоновщик понимает как расположение исполняемого файла или библиотеки.

Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_RPATHLINK

Указывает флаги компоновщика, необходимые для использования значений из QMAKE_RPATHLINKDIR.

Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_RELEASE

Указывает флаги компоновщика для релизных сборок. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_RELEASE_WITH_DEBUGINFO

Указывает флаги компоновщика для релизных сборок, где force_debug_info установлено в CONFIG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_APP

Указывает флаги компоновщика для построения приложений. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_SHLIB

Указывает флаги компоновщика, используемые для построения динамических библиотек. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_SONAME

Указывает флаги компоновщика для задания имени общих объектов, таких как .so или .dll. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_THREAD

Указывает флаги компоновщика для построения многопоточных проектов. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LFLAGS_WINDOWS

Примечание: Эта переменная используется только в Windows.

Указывает флаги компоновщика для построения проектов Windows GUI (то есть, приложений, не являющихся консольными). Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LIBDIR

Указывает список путей поиска библиотек для всех проектов. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

Чтобы указать дополнительные пути поиска в файлах проекта, используйте LIBS таким образом:

LIBS += -L/path/to/libraries

QMAKE_LIBDIR_POST

Указывает список путей поиска системных библиотек для всех проектов. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LIBDIR_FLAGS

Примечание: Эта переменная используется только на платформах Unix.

Указывает расположение всех каталогов библиотек с префиксом -L. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LIBDIR_EGL

Указывает расположение каталога EGL-библиотек, когда EGL используется с OpenGL/ES или OpenVG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко нуждается в изменении.

QMAKE_LIBDIR_OPENGL

Указывает расположение каталога библиотеки OpenGL. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

Если реализация OpenGL использует EGL (большинство систем OpenGL/ES), то также может потребоваться установить QMAKE_LIBDIR_EGL.

QMAKE_LIBDIR_OPENVG

Указывает расположение каталога библиотеки OpenVG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

Если реализация OpenVG использует EGL, то также может потребоваться установить QMAKE_LIBDIR_EGL.

QMAKE_LIBDIR_X11

Примечание: Эта переменная используется только на платформах Unix.

Указывает расположение каталога библиотеки X11. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_LIBS

Указывает дополнительные библиотеки, которые требуется подключать к каждому проекту. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

Чтобы указать библиотеки в файле проекта, используйте LIBS вместо этого.

QMAKE_LIBS_PRIVATE

Указывает дополнительные приватные библиотеки, которые требуется подключать к каждому проекту. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

Чтобы указать приватные библиотеки в файле проекта библиотеки, используйте LIBS_PRIVATE вместо этого.

QMAKE_LIBS_EGL

Указывает все EGL-библиотеки при сборке Qt с OpenGL/ES или OpenVG. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения. Обычно значение равно -lEGL.

QMAKE_LIBS_OPENGL

Указывает все OpenGL-библиотеки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

Если реализация OpenGL использует EGL (большинство систем OpenGL/ES), то также может потребоваться установить QMAKE_LIBS_EGL.

QMAKE_LIBS_OPENGL_ES1, QMAKE_LIBS_OPENGL_ES2

Эти переменные указывают все OpenGL-библиотеки для OpenGL ES 1 и OpenGL ES 2.

Значение этих переменных обычно обрабатывается qmake или qmake.conf и редко требует изменения.

Если реализация OpenGL использует EGL (большинство систем OpenGL/ES), то также может потребоваться установить QMAKE_LIBS_EGL.

QMAKE_LIBS_OPENVG

Указывает все OpenVG-библиотеки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения. Обычно значение равно -lOpenVG.

Некоторые движки OpenVG реализованы поверх OpenGL. Это будет определено во время конфигурирования, и QMAKE_LIBS_OPENGL будет неявно добавлен в QMAKE_LIBS_OPENVG, где подключаются OpenVG-библиотеки.

Если реализация OpenVG использует EGL, то также может потребоваться установить QMAKE_LIBS_EGL.

QMAKE_LIBS_THREAD

Примечание: Эта переменная используется только на платформах Unix.

Указывает все библиотеки, которые нужно подключать при построении многопоточного целевого объекта. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_LIBS_X11

Примечание: Эта переменная используется только на платформах Unix.

Указывает все X11-библиотеки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_LIB_FLAG

Эта переменная не пуста, если указан шаблон lib. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_LINK

Указывает компоновщик, который будет использоваться при построении приложений. Нужно указать только имя файла исполняемого файла компоновщика, если он находится в пути, указанном в переменной PATH при обработке Makefile. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_LINK_SHLIB_CMD

Указывает команду для выполнения при создании динамической библиотеки. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_LN_SHLIB

Указывает команду для выполнения при создании ссылки на динамическую библиотеку. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_LRELEASE_FLAGS

Список дополнительных параметров, передаваемых в lrelease при включении через CONFIG += lrelease.

QMAKE_OBJECTIVE_CFLAGS

Указывает флаги компилятора Objective C/C++ для построения проекта. Эти флаги используются дополнительно к QMAKE_CFLAGS и QMAKE_CXXFLAGS.

QMAKE_POST_LINK

Указывает команду для выполнения после компоновки TARGET. Эта переменная обычно пустая, поэтому ничего не выполняется.

Примечание: Эта переменная не имеет эффекта для проектов Xcode.

QMAKE_PRE_LINK

Указывает команду для выполнения перед компоновкой TARGET. Эта переменная обычно пустая, поэтому ничего не выполняется.

Примечание: Эта переменная не имеет эффекта для проектов Xcode.

QMAKE_PROJECT_NAME

Примечание: Эта переменная используется только для файлов проектов Visual Studio.

Определяет имя проекта при генерации файлов проекта для IDE. Значение по умолчанию — имя целевого объекта. Значение этой переменной обычно обрабатывается qmake и редко требует изменения.

QMAKE_PROVISIONING_PROFILE

Примечание: Эта переменная используется только на macOS, iOS, tvOS и watchOS.

UUID действительного профиля provisioning. Используется совместно с QMAKE_DEVELOPMENT_TEAM для указания профиля provisioning.

Примечание: Указание профиля provisioning отключает автоматическое управление подписанием.

QMAKE_MAC_SDK

Эта переменная используется на macOS при построении универсальных библиотек.

QMAKE_MACOSX_DEPLOYMENT_TARGET

Примечание: Эта переменная используется только на платформе macOS.

Указывает минимальную версию macOS, которую поддерживает приложение.

Дополнительную информацию см. в Разделах по зависимостям от версий macOS.

QMAKE_MAKEFILE

Указывает имя создаваемого Makefile. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_QMAKE

Содержит абсолютный путь к исполняемому файлу qmake.

Примечание: Не пытайтесь перезаписывать значение этой переменной.

QMAKE_RESOURCE_FLAGS

Эта переменная используется для настройки списка параметров, передаваемых в Компилятор ресурсов в каждом из правил построения, где она используется. Например, следующая строка гарантирует, что параметры -threshold и -compress используются с конкретными значениями каждый раз, когда вызывается rcc.

QMAKE_RESOURCE_FLAGS += -threshold 0 -compress 9

QMAKE_RPATHDIR

Примечание: Эта переменная используется только на платформах Unix.

Указывает список путей к библиотекам, которые добавляются в исполняемый файл во время компоновки, чтобы эти пути предпочтительно использовались во время выполнения.

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

QMAKE_RPATHLINKDIR

Указывает список путей к библиотекам для статического компоновщика для поиска неявных зависимостей динамических библиотек. Для получения дополнительной информации см. руководство к ld(1).

QMAKE_RUN_CC

Указывает индивидуальное правило для построения объекта. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_RUN_CC_IMP

Указывает индивидуальное правило для построения объекта. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_RUN_CXX

Указывает индивидуальное правило для построения объекта. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_RUN_CXX_IMP

Указывает индивидуальное правило для построения объекта. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_SONAME_PREFIX

Если определено, значение этой переменной используется в качестве пути, который будет добавлен к идентификатору скомпилированной динамической библиотеки SONAME. SONAME - это идентификатор, который динамический компоновщик позже будет использовать для ссылки на библиотеку. Как правило, эта ссылка может быть именем библиотеки или полным путем к библиотеке. На macOS, iOS, tvOS и watchOS путь может быть указан относительно с помощью следующих плейсхолдеров:

В большинстве случаев использование @rpath достаточно и рекомендуется:

# <project root>/project.pro
QMAKE_SONAME_PREFIX = @rpath

Однако префикс также может быть указан с помощью других плейсхолдеров или абсолютного пути, таких как один из следующих:

# <project root>/project.pro
QMAKE_SONAME_PREFIX = @executable_path/../Frameworks
QMAKE_SONAME_PREFIX = @loader_path/Frameworks
QMAKE_SONAME_PREFIX = /Library/Frameworks

Для получения дополнительной информации, см. документацию dyld по именам установок динамических библиотек.

QMAKE_TARGET

Указывает имя целевого проекта. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

QMAKE_TARGET_COMPANY

Только Windows. Указывает компанию для целевого проекта; это используется, где это применимо, для указания имени компании в свойствах приложения. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

QMAKE_TARGET_DESCRIPTION

Только Windows. Указывает описание для целевого проекта; это используется, где это применимо, для указания описания в свойствах приложения. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

QMAKE_TARGET_COPYRIGHT

Только Windows. Указывает информацию об авторском праве для целевого проекта; это используется, где это применимо, для указания информации об авторском праве в свойствах приложения. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

QMAKE_TARGET_PRODUCT

Только Windows. Указывает продукт для целевого проекта; это используется, где это применимо, для указания продукта в свойствах приложения. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

QMAKE_TARGET_ORIGINAL_FILENAME

Только Windows. Указывает исходное имя файла для целевого проекта; это используется, где это применимо, для указания исходного имени файла в свойствах приложения. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

QMAKE_TARGET_INTERNALNAME

Только Windows. Указывает внутреннее имя для целевого проекта; это используется, где это применимо, для указания внутреннего имени в свойствах приложения. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

QMAKE_TARGET_COMMENTS

Только Windows. Указывает комментарии для целевого проекта; это используется, где это применимо, для указания комментариев в свойствах приложения. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

QMAKE_TARGET_TRADEMARKS

Только Windows. Указывает информацию о товарных знаках для целевого проекта; это используется, где это применимо, для указания информации о товарных знаках в свойствах приложения. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

QMAKE_MANIFEST

Только Windows. Указывает файл манифеста для целевого проекта. Это используется только в том случае, если не установлены переменные RC_FILE и RES_FILE. Не забудьте удалить embed_manifest_exe и embed_manifest_dll из переменной CONFIG, иначе это будет конфликтовать с сгенерированным компилятором.

QMAKE_TVOS_DEPLOYMENT_TARGET

Примечание: Эта переменная используется только на платформе tvOS.

Указывает минимальную версию tvOS, которую поддерживает приложение.

Для получения дополнительной информации, см. Выражение поддерживаемых версий iOS.

QMAKE_UIC_FLAGS

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

QMAKE_WATCHOS_DEPLOYMENT_TARGET

Примечание: Эта переменная используется только на платформе watchOS.

Указывает минимальную версию watchOS, которую поддерживает приложение.

Для получения дополнительной информации, см. Выражение поддерживаемых версий iOS.

QML_IMPORT_MAJOR_VERSION

Указывает основную версию, которая будет использоваться для автоматической регистрации типов QML. Для получения дополнительной информации, см. Определение типов QML из C++.

QML_IMPORT_MINOR_VERSION

При автоматической регистрации типов QML, определенных в C++, регистрируется дополнительная версия модуля с использованием этой второстепенной версии. Как правило, второстепенные версии для регистрации выводятся из метаобъектов.

Вы можете использовать эту переменную, если метаобъекты не изменились, и вы по-прежнему хотите импортировать модуль QML с более новым номером второстепенной версии. Например, MyModule метаобъекты находятся на уровне 1.1, но вы хотите импортировать модуль как 1.3.

QML_IMPORT_VERSION

Указывает QML_IMPORT_MAJOR_VERSION и QML_IMPORT_MINOR_VERSION в виде <major>.<minor> строки версии.

QML_IMPORT_NAME

Указывает имя модуля, которое будет использоваться для автоматической регистрации типов QML. Для получения дополнительной информации, см. Определение типов QML из C++.

QML_FOREIGN_METATYPES

Указывает дополнительные JSON-файлы с метатипами, которые необходимо учитывать при генерации файлов qmltypes. Используйте это, когда внешние библиотеки предоставляют типы, которые экспонируются в QML, либо напрямую, либо как базовые типы или свойства других типов. Qt-типы будут автоматически учитываться и не нужно добавлять сюда.

QT

Указывает модули Qt, используемые вашим проектом. Значение для добавления для каждого модуля см. в документации модуля.

На уровне реализации C++, использование модуля Qt делает доступными его заголовки для включения и вызывает его связывание с двоичным файлом.

По умолчанию, QT содержит core и gui, гарантируя, что стандартные приложения графического интерфейса могут быть построены без дополнительной настройки.

Если вы хотите создать проект без модуля Qt GUI, вам нужно исключить значение gui с помощью оператора "-=". Следующая строка приведет к созданию минимального проекта Qt:

QT -= gui # Only the core module is used.

Если ваш проект — плагин Qt Designer, используйте значение uiplugin для указания, что проект должен быть создан как библиотека, но с поддержкой конкретных плагинов для Qt Designer. Для получения дополнительной информации, см. Создание и установка плагина.

QTPLUGIN

Указывает список имён статических плагинов Qt, которые должны быть связаны с приложением, чтобы они были доступны как встроенные ресурсы.

qmake автоматически добавляет плагины, которые обычно необходимы для используемых модулей Qt (см. QT). Значения по умолчанию настроены для оптимального опыта работы «из коробки». См. Статические плагины для списка доступных плагинов и способов переопределения автоматической связи.

Эта переменная в настоящее время не оказывает никакого влияния при связывании со сборкой Qt общего/динамического типа или при связывании библиотек. Она может быть использована для развертывания динамических плагинов в более позднее время.

QT_VERSION

Содержит текущую версию Qt.

QT_MAJOR_VERSION

Содержит текущую основную версию Qt.

QT_MINOR_VERSION

Содержит текущую второстепенную версию Qt.

QT_PATCH_VERSION

Содержит текущую версию исправления Qt.

RC_FILE

Только Windows. Указывает имя файла ресурсов Windows (.rc) для целевого объекта. См. Добавление файлов ресурсов Windows.

RC_CODEPAGE

Только Windows. Указывает кодовую страницу, которая должна быть указана в сгенерированном файле .rc. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

RC_DEFINES

Только Windows. qmake добавляет значения этой переменной как макросы препроцессора RC (/d опция). Если эта переменная не установлена, используется переменная DEFINES.

RC_DEFINES += USE_MY_STUFF

RC_ICONS

Только Windows. Указывает значки, которые должны быть включены в сгенерированный файл .rc. Это используется только в том случае, если переменные RC_FILE и RES_FILE не установлены. Более подробные сведения о генерации файлов .rc можно найти в Заметках по платформам.

RC_LANG

Только Windows. Указывает язык, который должен быть указан в сгенерированном файле .rc. Это используется только в том случае, если установлена переменная VERSION или RC_ICONS, и не установлены переменные RC_FILE и RES_FILE.

RC_INCLUDEPATH

Указывает пути включения, которые передаются в компилятор ресурсов Windows.

RCC_DIR

Указывает директорию для файлов выходных данных Qt Resource Compiler.

Например:

unix:RCC_DIR = ../myproject/resources
win32:RCC_DIR = c:/myproject/resources

REQUIRES

Указывает список значений, которые оцениваются как условия. Если любое из условий ложно, qmake пропускает этот проект (и его SUBDIRS) при построении.

Примечание: Мы рекомендуем использовать функцию requires() вместо этого, если вы хотите пропускать проекты или подпроекты при построении.

RESOURCES

Указывает имя файлов-коллекций ресурсов (qrc) для целевого файла. Более подробную информацию о файлах-коллекциях ресурсов см. в Системе ресурсов Qt.

RES_FILE

Только Windows. Указывает имя файла выходных данных компилятора ресурсов Windows для этого целевого файла. См. RC_FILE и Добавление файлов ресурсов Windows.

Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

SOURCES

Указывает имена всех исходных файлов в проекте.

Например:

SOURCES = myclass.cpp \
      login.cpp \
      mainwindow.cpp

См. также HEADERS.

SUBDIRS

Эта переменная, при использовании с subdirs template, указывает имена всех поддиректорий или файлов проекта, содержащих части проекта, которые необходимо построить. Каждая поддиректория, указанная с помощью этой переменной, должна содержать свой собственный файл проекта.

Рекомендуется, чтобы файл проекта в каждой поддиректории имел то же базовое имя, что и сама поддиректория, так как это позволяет опустить имя файла. Например, если поддиректория называется myapp, файл проекта в этой директории должен называться myapp.pro.

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

Например:

SUBDIRS = kernel \
          tools \
          myapp

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

Например:

SUBDIRS += my_executable my_library tests doc
my_executable.depends = my_library
tests.depends = my_executable

Вышеуказанная конфигурация гарантирует, что my_library будет построена до my_executable, а my_executable — до tests. Однако, doc может быть построено параллельно с другими поддиректориями, ускоряя процесс сборки.

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

Примечание: Использование CONFIG += ordered не рекомендуется, так как это может замедлить многопоточную сборку. В отличие от примера выше, все сборки будут происходить последовательно, даже если у них нет зависимостей.

Помимо определения порядка сборки, можно изменить стандартное поведение SUBDIRS , добавив дополнительные модификаторы к элементам SUBDIRS. Поддерживаемые модификаторы:

Например, определите две поддиректории, обе из которых находятся в другой директории, чем SUBDIRS значение, и одна из поддиректорий должна быть построена перед другой:

SUBDIRS += my_executable my_library
my_executable.subdir = app
my_executable.depends = my_library
my_library.subdir = lib

TARGET

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

Например:

TEMPLATE = app
TARGET = myapp
SOURCES = main.cpp

Файл проекта выше сгенерирует исполняемый файл, названный myapp на unix и myapp.exe на Windows.

TARGET_EXT

Указывает расширение TARGET. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

TARGET_x

Указывает расширение TARGET с номером основной версии. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

TARGET_x.y.z

Указывает расширение TARGET с номером версии. Значение этой переменной обычно обрабатывается qmake или qmake.conf и редко требует изменения.

TEMPLATE

Указывает имя шаблона, используемого при генерации проекта. Доступные значения:

Например:

TEMPLATE = lib
SOURCES = main.cpp
TARGET = mylib

Шаблон может быть переопределен путём указания нового типа шаблона с помощью опции командной строки -t. Это переопределяет тип шаблона после обработки файла .pro. С файлами .pro, использующими тип шаблона для определения способа построения проекта, необходимо объявить TEMPLATE в командной строке, а не использовать опцию -t.

TRANSLATIONS

Указывает список файлов переводов (.ts), содержащих переводы текста пользовательского интерфейса на языки, отличные от родного.

Файлы переводов в TRANSLATIONS будут обработаны как инструментом lrelease, так и инструментом Using lupdate. Используйте EXTRA_TRANSLATIONS, если вы хотите, чтобы только lrelease обрабатывал файл.

Вы можете использовать CONFIG += lrelease для автоматической компиляции файлов во время сборки и CONFIG += lrelease embed_translations, чтобы сделать их доступными в Системе ресурсов Qt.

См. Руководство Qt Linguist для получения дополнительной информации об интернационализации (i18n) и локализации (l10n) с Qt.

UI_DIR

Указывает директорию, где должны размещаться все промежуточные файлы из uic.

Например:

unix:UI_DIR = ../myproject/ui
win32:UI_DIR = c:/myproject/ui

VERSION

Указывает номер версии приложения, если задан app template, или номер версии библиотеки, если задан lib шаблон.

В Windows, выполняется автоматическое создание файла .rc, если переменные RC_FILE и RES_FILE не установлены. Сгенерированный файл .rc будет содержать записи FILEVERSION и PRODUCTVERSION, заполненные значениями основных, второстепенных, патч-уровней и номерами сборки. Каждый номер должен быть в диапазоне от 0 до 65535. Более подробную информацию о генерации файлов .rc можно найти в Примечания к платформе.

Например:

win32:VERSION = 1.2.3.4 # major.minor.patch.build
else:VERSION = 1.2.3    # major.minor.patch

VERSION_PE_HEADER

Только Windows. Указывает номер версии, который компоновщик Windows помещает в заголовок файла .exe или .dll с помощью опции /VERSION. Можно указать только основную и второстепенную версии. Если VERSION_PE_HEADER не задан, используется основная и второстепенная версии из VERSION (если задана).

VERSION_PE_HEADER = 1.2

VER_MAJ

Указывает номер основной версии библиотеки, если задан lib template.

VER_MIN

Указывает номер второстепенной версии библиотеки, если задан lib template.

VER_PAT

Указывает номер патч-версии библиотеки, если задан lib template.

VPATH

Указывает qmake, где искать файлы, которые она не может открыть. Например, если qmake ищет SOURCES, а находит запись, которую не может открыть, она перебирает весь список VPATH, чтобы посмотреть, сможет ли она найти файл самостоятельно.

См. также DEPENDPATH.

WINDOWS_TARGET_PLATFORM_VERSION

Указывает целевую версию Windows; это соответствует тегу WindowsTargetPlatformVersion в файлах vcxproj.

В настольных системах Windows значение по умолчанию — значение переменной среды WindowsSDKVersion.

WINDOWS_TARGET_PLATFORM_MIN_VERSION

Указывает минимальную версию целевой платформы Windows; это соответствует тегу WindowsTargetPlatformMinVersion в файлах vcxproj.

Значение по умолчанию — WINDOWS_TARGET_PLATFORM_VERSION.

YACCSOURCES

Указывает список файлов исходного кода Yacc, которые должны быть включены в проект. Все зависимости, заголовочные файлы и исходные файлы будут автоматически включены в проект.

Например:

YACCSOURCES = moc.y

_PRO_FILE_

Содержит путь к используемому файлу проекта.

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

message($$_PRO_FILE_)

Примечание: Не пытайтесь перезаписать значение этой переменной.

_PRO_FILE_PWD_

Содержит путь к каталогу, содержащему используемый файл проекта.

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

message($$_PRO_FILE_PWD_)

Примечание: Не пытайтесь перезаписать значение этой переменной.