自学内容网 自学内容网

Qt CMake

使用 CMake 构建

CMake 是一款用于简化跨不同平台开发项目的构建流程的工具。 CMake 可自动生成构建系统,如 Makefile 和 Visual Studio 项目文件。 CMake 是一个第三方工具,有自己的文档。 本主题介绍如何在 Qt 5 中使用 CMake 3.1.0。

开始使用 CMake

使用 find_package 查找 Qt 附带的库和头文件。 然后,您可以使用 target_link_libraries 命令来使用这些库和头文件,以构建基于 Qt 的库和应用程序。 例如,该命令会自动添加适当的包含目录、编译定义、位置无关代码标志,并链接到 Windows 上的 qtmain.lib 库。

构建 GUI 可执行文件

要构建 helloworld GUI 可执行文件,您需要具备以下条件:

cmake_minimum_required(VERSION 3.1.0)

project(helloworld VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)

if(CMAKE_VERSION VERSION_LESS "3.7.0")
    set(CMAKE_INCLUDE_CURRENT_DIR ON)
endif()

find_package(Qt5 COMPONENTS Widgets REQUIRED)

add_executable(helloworld
    mainwindow.ui
    mainwindow.cpp
    main.cpp
    resources.qrc
)

target_link_libraries(helloworld Qt5::Widgets)

要使 find_package 成功,CMake 必须通过以下方式之一找到 Qt 安装:

  • 将 CMAKE_PREFIX_PATH 环境变量设置为 Qt 5 安装前缀。这是推荐的方法。
  • 将 CMake 缓存中的 Qt5_DIR 设为 Qt5Config.cmake 文件的位置。

CMAKE_AUTOMOC 设置可在需要时自动运行 moc。更多详情,请参阅CMake AUTOMOC 文档。

导入库目标

每个加载的 Qt 模块都定义了一个 CMake 库目标。目标名称以 Qt5:: 开头,后跟模块名称。例如 Qt5::Core, Qt5::Gui。将目标库的名称传递给 target_link_libraries,即可使用相应的库。

注意:自 Qt 5.15 起,CMake 目标库也可作为 Qt::Core、Qt::Gui 等。这方便了编写可同时使用 Qt 5 和 Qt 6 的 CMake 代码。

导入目标创建时的配置与 Qt 配置时的配置相同。也就是说:

  • 如果 Qt 是用 -debug 开关配置的,则会创建一个带有 DEBUG 配置的导入目标。
  • 如果使用 -release 开关配置 Qt,则会创建一个具有 RELEASE 配置的导入目标。
  • 如果使用 -debug-and-release 开关配置 Qt,则会同时创建 RELEASE 和 DEBUG 配置的导入目标。

如果您的项目有自定义 CMake 编译配置,则必须将自定义配置映射到调试或发布 Qt 配置。

find_package(Qt5 COMPONENTS Core REQUIRED)

set(CMAKE_CXX_FLAGS_COVERAGE "${CMAKE_CXX_FLAGS_RELEASE} -fprofile-arcs -ftest-coverage")

# set up a mapping so that the Release configuration for the Qt imported target is
# used in the COVERAGE CMake configuration.
set_target_properties(Qt5::Core PROPERTIES MAP_IMPORTED_CONFIG_COVERAGE "RELEASE")

CMake 变量参考

模块变量

使用 find_package 加载的 Qt 模块会设置各种变量。

注意:您很少需要直接访问这些变量。 链接模块等常见任务应通过每个模块定义的库目标来完成。

例如,find_package(Qt5 COMPONENTS Widgets)(Qt5 COMPONENTS Widgets)成功加载后,将提供以下变量:

VariableDescription
Qt5Widgets_COMPILE_DEFINITIONS编译定义列表,用于根据该库进行编译。
Qt5Widgets_DEFINITIONS对照库构建时使用的定义列表。
Qt5Widgets_EXECUTABLE_COMPILE_FLAGS根据程序库构建可执行文件时使用的标志字符串。
Qt5Widgets_FOUND一个布尔值,用于描述是否成功找到模块。
Qt5Widgets_INCLUDE_DIRS针对程序库构建时使用的 include 目录列表。
Qt5Widgets_LIBRARIES模块导入目标的名称: Qt5::Widgets
Qt5Widgets_PRIVATE_INCLUDE_DIRS针对程序库构建和使用私有 Qt API 时要使用的私有 include 目录列表。
Qt5Widgets_VERSION_STRING包含模块版本的字符串。

对于使用 find_package 找到的所有软件包,这些变量都有对应的变量;它们区分大小写。

安装变量

此外,还有一些变量与特定软件包无关,而是与 Qt 安装本身有关。

QT_DEFAULT_MAJOR_VERSION一个整数,用于控制 Qt 5 和 Qt 6 混合项目中 qt_ 命令转发的 Qt 版本。 需要在调用相应的 find_package() 之前将其设置为 5 或 6。 如果设置为 5,以 qt_ 开始的命令将调用以 qt5_ 开始的对应版本。 如果设置为 6,则会调用以 qt6_ 开始的对应命令。 如果未设置,第一次 find_package 调用将定义默认版本。 此功能在 Qt 5.15 中添加。
QT_LIBINFIX当 Qt 使用 -libinfix 配置时,用于保存库名中使用的后缀的字符串。
QT_NO_CREATE_VERSIONLESS_FUNCTIONS自 Qt 5.15 起,模块不仅定义以 qt5_ 开头的命令,还定义以 qt_ 开头的命令。 你可以在 find_package 之前设置 QT_NO_CREATE_VERSIONLESS_FUNCTIONS,以防止出现这种情况。
QT_NO_CREATE_VERSIONLESS_TARGETS自 Qt 5.15 起,模块不仅定义以 Qt5:: 开头的目标,还定义以 Qt:: 开头的目标。 你可以在 find_package 之前设置 QT_NO_CREATE_VERSIONLESS_TARGETS,以防止出现这种情况。
QT_VISIBILITY_AVAILABLE在 Unix 上,一个布尔值,用于说明 Qt 库和插件在编译时是否使用了 -fvisibility=hidden。 这意味着只导出选定的符号。

CMake 命令参考

Qt5::Core

qt5_add_big_resources

将大型二进制资源编译成目标代码

qt5_add_binary_resources

从 Qt 资源文件列表中创建 RCC 文件

qt5_add_resources

将二进制资源编译成源代码

qt5_generate_moc

在输入文件上调用 moc

qt5_import_plugins

为静态 Qt 构建指定要导入的自定义插件集

qt5_wrap_cpp

从源代码创建 .moc 文件

qt_add_big_resources

将大型二进制资源编译成目标代码

qt_add_binary_resources

从 Qt 资源文件列表中创建 RCC 文件

qt_add_resources

将二进制资源编译成源代码

qt_generate_moc

在输入文件上调用 moc

qt_import_plugins

为静态 Qt 构建指定要导入的自定义插件集

qt_wrap_cpp

从源代码创建 .moc 文件

Qt5::DBus

qt_add_dbus_adaptor

为 D-Bus 接口生成适配器类

qt_add_dbus_interface

为 D-Bus 接口描述文件生成实现接口的 C++ 源代码

qt_add_dbus_interfaces

为 D-Bus 接口描述文件生成实现接口的 C++ 源代码

qt_generate_dbus_interface

从头文件生成 D-Bus 接口

Qt5::LinguistTools

qt5_add_translation

将 Qt Linguist .ts 文件编译成 .qm 文件

qt5_create_translation

设置 Qt Linguist 翻译工具链

Qt5::RemoteObjects

qt5_generate_repc

从 Qt Remote Objects .rep 文件创建 C++ 类型

Qt5::Widgets

qt5_wrap_ui

为 .ui 文件创建源代码

qt_wrap_ui

为 .ui 文件创建源代码

CMake Command Reference | Build with CMake 5.15.17 (qt.io)


原文地址:https://blog.csdn.net/qq_32640443/article/details/142643223

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!