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）成功加载后，将提供以下变量：

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

安装变量

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

CMake 命令参考

Qt5::DBus

Qt5::LinguistTools

Qt5::RemoteObjects

Qt5::Widgets

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