CMake+QT使用教程_qt cmake

一、CMake入门

下面是使用 Qt 用 C++ 编写的控制台应用程序的典型文件：CMakeLists.txt

1.构建一个控制台应用程序

# 指定应用程序所需的CMake最低版本（Qt本身至少需要CMake版本3.16）
cmake_minimum_required(VERSION 3.16)

# 设置项目名称和默认项目版本，同时告诉CMake该程序是用C++编写的
project(helloworld VERSION 1.0.0 LANGUAGES CXX)

# 设置变量CMAKE_CXX_STANDARD，指定C++版本（QT6需要支持c++ 17或更新版本的编译器）
# 设置变量CMAKE_CXX_STANDARD_REQUIRED，如果编译器太旧，让CMake打印一个错误
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 设置CMake查找Qt6，并导入模块Core
# 如果CMake找不到模块，设置标志REQUIRED让CMake终止
# 如果成功，CMake将设置一些变量，这些变量记录在模块变量中（见变量参考Module variables）
# 为了能找到依赖包，CMake可以设置变量CMAKE_PREFIX_PATH包含Qt6安装前缀
find_package(Qt6 REQUIRED COMPONENTS Core)

# qt_standard_project_setup命令为一般的QT应用程序设置项目范围的默认值
# 除此之外，该命令将CMAKE_AUTOMOC变量设置为ON，指示CMake自动设置规则，以便在需要时透明地调用Qt的元对象编译器(moc)。
qt_standard_project_setup()

# add_executable命令告诉CMake从指定源文件构建一个可执行文件（而不是库）
# 注意，这里通常不列出头文件。这与qmake不同，qmake需要显式列出头文件，以便元对象编译器(moc)处理它们。
# 对于比较复杂的项目需要改为调用qt_add_executable()，它是内置add_executable()命令的包装器，提供了额外的逻辑来自动处理诸如在静态Qt构建中链接Qt插件、特定于平台的库名定制等。
# 要创建库，使用qt_add_library。
add_executable(helloworld
    main.cpp
)

# 最后告诉CMake, helloworld可执行文件通过引用由上面的find_package()调用导入的Qt6::Core目标来使用Qt的Core模块。这不仅可以为链接器添加正确的参数，还可以确保将正确的include目录、编译器定义传递给c++编译器。PRIVATE关键字对于可执行目标并不是严格必要的，但是指定它是一种良好的实践。
# 如果helloworld是一个库而不是可执行文件，则应该指定PRIVATE或PUBLIC(如果库在头文件中提到了来自Qt6::Core的内容，则为PUBLIC，否则为PRIVATE)
target_link_libraries(helloworld PRIVATE Qt6::Core)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

2.构建一个界面应用程序

cmake_minimum_required(VERSION 3.16)

project(helloworld VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 REQUIRED COMPONENTS Widgets)
qt_standard_project_setup()

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

target_link_libraries(helloworld PRIVATE Qt6::Widgets)

# 最后，我们在应用程序目标上设置属性，效果如下:
# 防止在Windows上创建控制台窗口。
# 在macOS上创建应用程序包。
set_target_properties(helloworld PROPERTIES
    WIN32_EXECUTABLE ON
    MACOSX_BUNDLE ON
)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

3.构建子目录项目

• 项目目录结构

<project root>
├── CMakeLists.txt
└── src
    └── app
        ├── CMakeLists.txt
        ├── main.cpp
        ├── mainwindow.cpp
        ├── mainwindow.h
        └── mainwindow.ui
1
2
3
4
5
6
7
8
9

• 顶层CMakeLists.txt，包含整个项目的设置并调用add_subdirectory，顶层CMakeLists.txt设置的变量在子目录项目中可见

cmake_minimum_required(VERSION 3.16)

project(helloworld VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 REQUIRED COMPONENTS Widgets)
qt_standard_project_setup()

add_subdirectory(src/app)
1
2
3
4
5
6
7
8
9
10
11

• 子目录项目CMakeLists.txt

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

target_link_libraries(helloworld PRIVATE Qt6::Widgets)

set_target_properties(helloworld PROPERTIES
    WIN32_EXECUTABLE ON
    MACOSX_BUNDLE ON
)
1
2
3
4
5
6
7
8
9
10
11
12

4.构建库和使用库

• 项目目录结构

<project root>
├── CMakeLists.txt
└── src
    ├── app
    │   ├── ...
    │   └── main.cpp
    └── businesslogic
        ├── CMakeLists.txt
        ├── businesslogic.cpp
        └── businesslogic.h
1
2
3
4
5
6
7
8
9
10

• 库项目文件（src/businesslogic/CMakeLists.txt）

# add_library命令创建businesslogic库，STATIC表示静态库，SHARED表示动态库
add_library(businesslogic STATIC
    businesslogic.cpp
)

target_link_libraries(businesslogic PRIVATE Qt6::Core)

# 通过调用target_include_directories，确保businesslogic目录的绝对路径被自动添加为使用我们的库的所有目标的包含路径。
# 这使我们在main.cpp中不用使用相对路径来定位businesslogic.h。相反，我们可以直接写#include <businesslogic.h>
target_include_directories(businesslogic INTERFACE ${CMAKE_CURRENT_SOURCE_DIR})
1
2
3
4
5
6
7
8
9
10

最后，我们必须将库的子目录添加到顶级项目文件中:

add_subdirectory(src/app)
add_subdirectory(src/businesslogic)
1
2

• 使用库

target_link_libraries(helloworld PRIVATE
    businesslogic
    Qt6::Widgets)
1
2
3

5.添加资源

qt_add_resources(helloworld imageresources
    PREFIX "/images"
    FILES logo.png splashscreen.png
)
1
2
3
4

用法：

logoLabel->setPixmap(QPixmap(":/images/logo.png"));
1

6.添加翻译

qt_add_translations(helloworld
    TS_FILES helloworld_de.ts helloworld_fr.ts)
1
2

要更新.ts文件中的条目，构建update_translations目标:

$ cmake --build . --target update_translations
1

要手动触发.qm文件的生成，构建release_translations目标:

$ cmake --build . --target release_translations
1

二、CMake命令参考（CMake Command Reference）

• Qt6::Core

  CMake命令	描述
  qt_add_big_resources	将大型二进制资源编译为目标代码
  qt_add_binary_resources	从 Qt 资源文件列表创建 RCC 文件
  qt_add_executable	创建并最终确定指定平台类型的应用程序目标
  qt_add_library	创建并完成库
  qt_add_plugin	创建 Qt 插件目标
  qt_add_resources	将二进制资源编译为源代码
  qt_allow_non_utf8_sources	防止强制将源文件视为适用于 Windows 的 UTF-8
  qt_android_add_apk_target	定义运行安卓部署qt以生成APK的构建目标
  qt_android_apply_arch_suffix	将目标二进制文件的名称配置为包含特定于体系结构的后缀
  qt_android_generate_deployment_settings	生成 androiddeployqt 所需的部署设置文件
  qt_deploy_qt_conf	在部署时编写 qt.conf 文件
  qt_deploy_runtime_dependencies	部署可执行文件所需的Qt插件，Qt和非Qt库
  qt_disable_unicode_defines	防止在目标上自动设置某些与 Unicode 相关的编译器定义
  qt_extract_metatypes	防止在目标上自动设置某些与 Unicode 相关的编译器定义
  qt_finalize_project	处理与Qt项目相关的各种常见平台特定任务
  qt_finalize_target	处理与Qt目标相关的各种常见平台特定任务
  qt_generate_deploy_app_script	为应用程序生成部署脚本
  qt_generate_moc	对输入文件调用 moc
  qt_import_plugins	指定要为静态Qt构建导入的自定义插件集
  qt_set_finalizer_mode	自定义目标最终确定的各个方面
  qt_standard_project_setup	将项目范围的默认设置设置为标准排列
  qt_wrap_cpp	从源文件创建.moc文件

• Qt6::DBus

  CMake命令	描述
  qt_add_dbus_adaptor	将项目范围的默认设置设置为标准排列
  qt_add_dbus_interface	生成实现 D-Bus 接口描述文件接口的C++源
  qt_add_dbus_interfaces	生成实现 D-Bus 接口描述文件接口的C++源
  qt_generate_dbus_interface	从头文件生成 D-Bus 接口

• Qt6::InterfaceFramework

  CMake命令	描述
  qt_ifcodegen_extend_target	使用从 qface IDL 文件生成的文件扩展目标
  qt_ifcodegen_generate	从 qface IDL 文件生成文件
  qt_ifcodegen_import_variables	从 qface IDL 文件生成文件，并提供变量以在 CMake 中使用
  qt_set_ifcodegen_variable	将变量设置为 ifcodegen 模板中的给定 c 值

• Qt6::LinguistTools

  CMake命令	描述
  qt_add_lrelease	添加目标以将Qt语言学家.ts文件转换为.qm文件
  qt_add_lupdate	添加目标以生成或更新Qt语言学家.ts文件
  qt_add_translation	添加目标以生成或更新Qt语言学家.ts文件
  qt_add_translations	添加目标以更新Qt Linguist .ts文件并将其转换为.qm文件
  qt_create_translation	设置Qt语言学家翻译工具链

• Qt6::Qml

  CMake命令	描述
  qt_add_qml_module	设置Qt语言学家翻译工具链
  qt_add_qml_plugin	定义与 QML 模块关联的插件
  qt_deploy_qml_imports	部署可执行文件所需的 QML 模块的运行时组件
  qt_generate_deploy_qml_app_script	为 QML 应用程序生成部署脚本
  qt_generate_foreign_qml_types	在 QML 模块中注册来自一个目标的类型
  qt_import_qml_plugins	确保为静态构建导入目标所需的 QML 插件
  qt_query_qml_module	检索有关 QML 模块的信息
  qt_target_compile_qml_to_cpp
  qt_target_qml_sources	检索有关 QML 模块的信息

• Qt6::RemoteObjects

  CMake命令	描述
  qt_add_repc_merged	从 Qt 远程对象 .rep 文件为源和副本类型创建C++头文件
  qt_add_repc_replicas	从 Qt 远程对象 .rep 文件为副本类型创建C++头文件
  qt_add_repc_sources	从 Qt 远程对象 .rep 文件为源类型创建C++头文件
  qt_reps_from_headers	从 QObject 头文件创建 .rep 文件

• Qt6::Scxml

  CMake命令	描述
  qt_add_statecharts

• Qt6::ShaderTools

  CMake命令	描述
  Qt Shader Tools Build System Integration	编译着色器并将其添加到Qt资源

• Qt6::Widgets

  CMake命令	描述
  qt_wrap_ui	编译着色器并将其添加到Qt资源

• Qt6::WebEngineCore

  CMake命令	描述
  qt_add_webengine_dictionary	将 hunspell 字典格式转换为 bdict 二进制格式

三、CMake变量参考（CMake Variable Reference）

1.模块变量（Module variables）

2.安装变量（Installation variables）

3.项目变量（Project variables）

• Qt6::Core

• Qt6::Qml

• Qt6::InterfaceFramework

四、CMake属性参考（CMake Property Reference）

• Qt6::Core

  目标属性

源文件属性

• Qt6::DBus

源文件属性

• Qt6::Qml

源文件属性