Spec-Zone.ru › CMake 3.13

cmake-qt(7)

  • Введение
  • Инструменты построения Qt
    • AUTOMOC
    • AUTOUIC
    • AUTORCC
  • Генераторы Visual Studio
  • qtmain.lib в Windows

Введение

CMake может находить и использовать библиотеки Qt 4 и Qt 5. Библиотеки Qt 4 находятся с помощью модуля поиска FindQt4, поставляемого с CMake, в то время как библиотеки Qt 5 находятся с помощью «пакетов файлов конфигурации», поставляемых с Qt 5. См. cmake-packages(7) для получения дополнительной информации о пакетах CMake, и см. справочник Qt CMake для вашей версии Qt.

Qt 4 и Qt 5 могут использоваться вместе в одном CMake buildsystem:

cmake_minimum_required(VERSION 3.8.0 FATAL_ERROR)

project(Qt4And5)

set(CMAKE_AUTOMOC ON)

find_package(Qt5 COMPONENTS Widgets DBus REQUIRED)
add_executable(publisher publisher.cpp)
target_link_libraries(publisher Qt5::Widgets Qt5::DBus)

find_package(Qt4 REQUIRED)
add_executable(subscriber subscriber.cpp)
target_link_libraries(subscriber Qt4::QtGui Qt4::QtDBus)

Целевой объект CMake не может быть связан как с Qt 4, так и с Qt 5. Выдаётся диагностическое сообщение, если это пытается сделать или происходит из-за зависимости целевого объекта.

Инструменты построения Qt

Qt полагается на некоторые интегрированные инструменты для генерации кода, такие как moc для генерации метаобъектного кода, uic для макета и заполнения виджетов, и rcc для генерации контента виртуальной файловой системы. Эти инструменты могут быть автоматически вызваны командой cmake(1), если выполнены соответствующие условия. Автоматический вызов инструментов можно использовать как с Qt 4, так и с Qt 5.

Инструменты выполняются как часть синтезированного пользовательского целевого объекта, сгенерированного CMake. Зависимости целевых объектов могут быть добавлены к этому пользовательскому целевому объекту, добавив их в свойство целевого объекта AUTOGEN_TARGET_DEPENDS.

AUTOMOC

Свойство целевого объекта AUTOMOC контролирует, будет ли cmake(1) проверять файлы C++ в целевом объекте, чтобы определить, нужно ли выполнить moc, и создать правила для выполнения moc в соответствующее время.

Если макрос из AUTOMOC_MACRO_NAMES найден в файле заголовка, moc будет запущен для файла. Результат будет помещён в файл, имя которого соответствует moc_<basename>.cpp. Если макрос найден в файле реализации C++, вывод moc будет помещён в файл с именем, соответствующим <basename>.moc, следуя соглашениям Qt. <basename>.moc должен быть включён пользователем в файл реализации C++ с помощью препроцессора #include.

Включённые moc_*.cpp и *.moc файлы будут сгенерированы в каталоге <AUTOGEN_BUILD_DIR>/include, который автоматически добавляется в INCLUDE_DIRECTORIES целевого объекта.

  • Это отличается от CMake 3.7 и ниже; см. их документацию для получения подробностей.
  • Для multi configuration generators каталог включений — <AUTOGEN_BUILD_DIR>/include_<CONFIG>.
  • См. AUTOGEN_BUILD_DIR.

Не включённые moc_<basename>.cpp файлы будут сгенерированы в пользовательских папках, чтобы избежать конфликтов имён, и включены в отдельный файл <AUTOGEN_BUILD_DIR>/mocs_compilation.cpp, который компилируется в целевой объект.

  • См. AUTOGEN_BUILD_DIR.

Команда moc будет использовать свойства целевого объекта COMPILE_DEFINITIONS и INCLUDE_DIRECTORIES из целевого объекта, для которого она вызывается, и для соответствующей конфигурации сборки.

Свойство целевого объекта AUTOMOC может быть предварительно установлено для всех последующих целевых объектов путём установки переменной CMAKE_AUTOMOC. Свойство целевого объекта AUTOMOC_MOC_OPTIONS может быть заполнен для установки параметров, передаваемых в moc. Переменная CMAKE_AUTOMOC_MOC_OPTIONS может быть заполнена для предварительной установки параметров для всех последующих целевых объектов.

Дополнительные имена макросов для поиска можно добавить в AUTOMOC_MACRO_NAMES.

Дополнительные имена файлов зависимостей moc могут быть извлечены из исходного кода с помощью AUTOMOC_DEPEND_FILTERS.

Исходные файлы C++ могут быть исключены из обработки AUTOMOC, включив SKIP_AUTOMOC или более широкое SKIP_AUTOGEN.

AUTOUIC

Свойство целевого объекта AUTOUIC управляет тем, будет ли cmake(1) проверять файлы C++ в целевом объекте, чтобы определить, нужно ли выполнить uic, и создать правила для выполнения uic в соответствующее время.

Если найден препроцессорная директива #include, которая соответствует <path>ui_<basename>.h, и существует файл <basename>.ui, то uic будет выполнен для генерации соответствующего файла. Файл <basename>.ui ищется в следующих местах

  1. <source_dir>/<basename>.ui
  2. <source_dir>/<path><basename>.ui
  3. <AUTOUIC_SEARCH_PATHS>/<basename>.ui
  4. <AUTOUIC_SEARCH_PATHS>/<path><basename>.ui

где <source_dir> — это каталог файла C++, а AUTOUIC_SEARCH_PATHS — список дополнительных путей поиска.

Сгенерированные файлы ui_*.h размещаются в каталоге <AUTOGEN_BUILD_DIR>/include, который автоматически добавляется в INCLUDE_DIRECTORIES целевого объекта.

  • Это отличается от CMake 3.7 и ниже; см. их документацию для получения подробностей.
  • Для multi configuration generators каталог включений — <AUTOGEN_BUILD_DIR>/include_<CONFIG>.
  • См. AUTOGEN_BUILD_DIR.

Свойство целевого объекта AUTOUIC может быть предварительно установлено для всех последующих целевых объектов путём установки переменной CMAKE_AUTOUIC. Свойство целевого объекта AUTOUIC_OPTIONS может быть заполнен для установки параметров, передаваемых в uic. Переменная CMAKE_AUTOUIC_OPTIONS может быть заполнена для предварительной установки параметров для всех последующих целевых объектов. Свойство файла исходного кода AUTOUIC_OPTIONS может быть установлено для файла <basename>.ui, чтобы установить конкретные параметры для файла. Это переопределяет параметры из свойства целевого объекта AUTOUIC_OPTIONS.

Целевая зависимость может заполнить свойство INTERFACE_AUTOUIC_OPTIONS целевого свойства параметрами, которые должны использоваться при вызове uic. Это должно соответствовать содержимому свойства AUTOUIC_OPTIONS целевого свойства зависимой целевой зависимости. Переменная CMAKE_DEBUG_TARGET_PROPERTIES может использоваться для отслеживания исходной целевой зависимости таких INTERFACE_AUTOUIC_OPTIONS. Это означает, что библиотека, которая предоставляет альтернативную систему перевода для Qt, может указать параметры, которые следует использовать при запуске uic:

add_library(KI18n klocalizedstring.cpp)
target_link_libraries(KI18n Qt5::Core)

# KI18n uses the tr2i18n() function instead of tr().  That function is
# declared in the klocalizedstring.h header.
set(autouic_options
  -tr tr2i18n
  -include klocalizedstring.h
)

set_property(TARGET KI18n APPEND PROPERTY
  INTERFACE_AUTOUIC_OPTIONS ${autouic_options}
)

Проект, использующий целевую зависимость, экспортированную из upstream, автоматически использует соответствующие параметры, когда uic выполняется AUTOUIC, в результате связывания с целевой зависимостью IMPORTED:

set(CMAKE_AUTOUIC ON)
# Uses a libwidget.ui file:
add_library(LibWidget libwidget.cpp)
target_link_libraries(LibWidget
  KF5::KI18n
  Qt5::Widgets
)

Файлы исходного кода можно исключить из обработки AUTOUIC, включив SKIP_AUTOUIC или более широкое свойство SKIP_AUTOGEN.

AUTORCC

Свойство целевой зависимости AUTORCC определяет, создаёт ли cmake(1) правила для выполнения rcc в нужное время для файлов исходного кода, имеющих расширение .qrc.

add_executable(myexe main.cpp resource_file.qrc)

Свойство целевой зависимости AUTORCC можно задать по умолчанию для всех последующих зависимостей, установив переменную CMAKE_AUTORCC. Свойство целевой зависимости AUTORCC_OPTIONS можно заполнить для установки параметров, которые будут переданы rcc. Переменную CMAKE_AUTORCC_OPTIONS можно заполнить для предварительной установки параметров для всех последующих зависимостей. Свойство файла исходного кода AUTORCC_OPTIONS можно установить для файла <name>.qrc для установки определённых параметров для файла. Это переопределяет параметры из свойства целевой зависимости AUTORCC_OPTIONS.

Файлы исходного кода можно исключить из обработки AUTORCC, включив SKIP_AUTORCC или более широкое свойство SKIP_AUTOGEN.

Генераторы Visual Studio

При использовании Visual Studio generators, CMake использует PRE_BUILD custom command для AUTOMOC и AUTOUIC. Если обработка AUTOMOC и AUTOUIC зависит от файлов, используется custom target. Это происходит, когда

  • Исходная целевая зависимость зависит от файлов GENERATED, которые не исключены из AUTOMOC и AUTOUIC с помощью SKIP_AUTOMOC, SKIP_AUTOUIC, SKIP_AUTOGEN или CMP0071
  • AUTOGEN_TARGET_DEPENDS перечисляет файл исходного кода

qtmain.lib в Windows

Целевые зависимости Qt 4 и 5 для библиотек QtGui указывают, что статическая библиотека qtmain.lib, поставляемая с Qt, будет подключена ко всем зависимым исполняемым файлам, у которых включено свойство WIN32_EXECUTABLE.

Чтобы отключить это поведение, включите свойство целевой зависимости Qt5_NO_LINK_QTMAIN для целевых зависимостей Qt 5 или свойство целевой зависимости QT4_NO_LINK_QTMAIN для целевых зависимостей Qt 4.

add_executable(myexe WIN32 main.cpp)
target_link_libraries(myexe Qt4::QtGui)

add_executable(myexe_no_qtmain WIN32 main_no_qtmain.cpp)
set_property(TARGET main_no_qtmain PROPERTY QT4_NO_LINK_QTMAIN ON)
target_link_libraries(main_no_qtmain Qt4::QtGui)

© 2000–2019 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.13/manual/cmake-qt.7.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API