Qt 编译方式之 cmake

最新推荐文章于 2024-04-24 18:39:07 发布
最新推荐文章于 2024-04-24 18:39:07 发布
阅读量2.1w 收藏 170
点赞数 21
分类专栏： Qt 文章标签： Qt cmake cmake常用命令
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_34139994/article/details/93618195
版权

作者：billy
版权声明：著作权归作者所有，商业转载请联系作者获得授权，非商业转载请注明出处

CMake简介

CMake是一个跨平台的、开源的构建工具。cmake是makefile的上层工具，它们的目的正是为了产生可移植的makefile，并简化自己动手写makefile时的巨大工作量。目前很多开源的项目都可以通过CMake工具来轻松构建工程，例如博客之前分享的openHMD、hidapi、OSVR-Core等等，代码的分享者提供源代码和相应的Cmake配置文件，使用者就可以非常方便的在自己的电脑上构建相应的工程，进行开发和调试。

Qmake VS Cmake

  • qmake 是为 Qt 量身打造的，使用起来非常方便
  • cmake 使用上不如qmake简单直接，但复杂换来的是强大的功能
    • 内置的 out-of source 构建（目前QtCreator为qmake也默认启用了该功能，详情请搜索“Qt影子构建”）
    • 为各种平台和场景提供条件编译
    • 可处理多个可执行文件情况，和很好配合 QtTest 工作
如何选择构建方式?

Using CMake to Build Qt Projects 此书中提到：
对简单的Qt工程，采用 qmake
对复杂度超过 qmake 处理能力的，采用 cmake（例如程序中调用了很多第三方库）

接下来我们就一起来学习下CMake的语法和常用命令。

基本语法规则

  1. 变量使用 ${} 方式取值，但是在 IF 控制语句 中是直接使用变量名
  2. 指令(参数 1 参数 2…)，参数使用括弧括起，参数之间使用空格或分号分开
  3. 指令是大小写无关的，参数和变量是大小写相关的，推荐全部使用大写指令

CMake常用命令

  1. CMAKE_MINIMUM_REQUIRED (VERSION2.6 FATAL_ERROR)
    功能：规定cmake程序的最低版本
    这行命令是可选的，我们可以不写这句话，但在有些情况下，如果CMakeLists.txt文件中使用了一些高版本cmake特有的一些命令的时候，就需要加上这样一行，提醒用户升级到该版本之后再执行cmake

  2. PROJECT(<Name>)
    功能：用于指定项目的名称
    这条指令会自动创建两个变量：
    <projectnam>_SOURCE_DIR（源代码路径） 和 <projectname>_BINARY_DIR（二进制文件保存路径）
    cmake系统也帮助我们预定义了 PROJECT_SOURCE_DIR 和 PROJECT_BINARY_DIR 其值与上述对应相等
    PROJECT_SOURCE_DIR 指向的目录同内部构建相同，仍然是项目目录
    而 PROJECT_BINARY_DIR 则有所不同，指向<项目目录>/build目录

  3. INCLUDE_DIRECTORIES ([AFTER|BEFORE] [SYSTEM] dir1 dir2 …)
    功能：设置头文件位置
    向工程添加多个特定的头文件搜索路径，路径之间用空格分隔，如果路径包含空格，可以使用双引号将它括起来，默认的行为是追加到当前头文件搜索路径的后面

  4. ADD_LIBRARY(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2 … sourceN)
    功能：添加动态静态库

    • 添加一个名为<libname>的库文件
    • 指定STATIC, SHARED, MODULE参数来指定要创建的库的类型, STATIC对应的静态库(.a)，SHARED对应共享动态库(.so)
    • [EXCLUDE_FROM_ALL], 如果指定了这一属性，对应的一些属性会在目标被创建时被设置(指明此目录和子目录中所有的目标，是否应当从默认构建中排除, 子目录的IDE工程文件/Makefile将从顶级IDE工程文件/Makefile中排除)
    • source1 source2 … sourceN用来指定源文件

  5. ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
    功能：去子目录中查看可用的CMakeLists.txt文件
    如果当前目录下还有子目录时可以使用add_subdirectory，子目录中也需要包含有CMakeLists.txt
    EXCLUDE_FROM_ALL含义：将这个目录从编译过程中排除

  6. ADD_EXECUTABLE( [WIN32] [MACOSX_BUNDLE] [EXCLUDE_FROM_ALL] [source1] [source2 …])
    功能：添加可执行文件
    例：ADD_EXECUTABLE(hello ${SRC_LIST})
    定义了这个工程会生成一个文件名为 hello 的可执行文件，相关的源文件是 SRC_LIST 中定义的源文件列表
    这里的 hello 和之前的项目名称没有任何关系，可以任意定义

  7. ADD_DEPENDENCIES(target-name depend-target1 depend-target2 …)
    功能：用于添加编译器命令行标志（选项），通常的情况下我们使用其来添加预处理器定义
    让一个顶层目标依赖于其他的顶层目标，保证某个目标在其他的目标之前被构建

  8. TARGET_LINK_LIBRARIES(<name> lib1 lib2 lib3)
    功能：将若干库链接到目标库文件
    例如：TARGET_LINK_LIBRARIES(hello log4cpp thrift)
    这句话指定在链接目标文件的时候需要链接的外部库，其效果类似gcc的编译参数“-l”，可以解决外部库的依赖问题

  9. SET_PROPERTY
    功能：在给定的作用域内设置一个命名的属性，PROPERTY参数是必须的

set_property(<GLOBAL | 
            DIRECTORY [dir] | 
            TARGET [target ...] | 
            SOURCE [src1 ...] | 
            TEST [test1 ...] | 
            CACHE [entry1 ...]>
            [APPEND] 
            PROPERTY <name> [value ...])
             
第一个参数决定了属性可以影响的作用域,必须为以下值：
GLOBAL 全局作作用域,不接受名字
DIRECTORY 默认为当前路径，但是同样也可以用[dir]指定路径
TARGET 目标作用，可以是0个或多个已有的目标
SOURCE 源作用域， 可以是0个过多个源文件
TEST 测试作用域, 可以是0个或多个已有的测试
CACHE 必须指定0个或多个cache中已有的条目

  1. SET_DIRECTORY_PROPERTIES(PROPERTIES prop1 value1 prop2 value2)
    功能：设置某个路径的一种属性
    prop1 prop2代表属性，取值为：
    INCLUDE_DIRECTORIES
    LINK_DIRECTORIES
    INCLUDE_REGULAR_EXPRESSION
    ADDITIONAL_MAKE_CLEAN_FILES

  2. MESSAGE([STATUS|WARNING|AUTHOR_WARNING|FATAL_ERROR|SEND_ERROR] “message todisplay”…)
    功能：向终端输出用户定义的信息或变量的值
    SEND_ERROR 产生错误，生成过程被跳过
    STATUS 输出前缀为—的信息
    FATAL_ERROR 立即终止所有cmake过程

  3. FIND_LIBRARY(<VAR> name1 [path1 path2 …])
    功能：用于查找库文件 name1 的路径，如果找到则将路径保存在 VAR 中（此路径为一个绝对路径），如果没有找到则=结果为 <VAR>-NOTFOUND

  4. FIND_PACKAGE(<Name>)
    功能：找相应库的模块
    windows下并不是很重要，但是在Unix下就非常重要了，find_package可以根据cmake内置的.cmake的脚本去找相应的库的模块，内建了很多库的模块变量，当调用了FIND_PACKAGE之后会有相应的变量生效

  5. SET(VAR [VALUE] [CACHE TYPEDOCSTRING [FORCE]])
    功能：用于设置变量，相当于为变量取别名
    SET(CMAKE_BUILE_TYPE DEBUG) 设置编译类型debug 或者release，debug 版会生成相关调试信息，可以使用GDB 进行调试；release不会生成调试信息
    SET(CMAKE_C_FLAGS_DEBUG “-g -Wall”) 设置编译器的类型

  6. FILE
    功能：文件操作命令

# 将message写入filename文件中,会覆盖文件原有内容
file(WRITE filename "message")

# 将message写入filename文件中，会追加在文件末尾
file(APPEND filename "message")

# 从filename文件中读取内容并存储到var变量中，如果指定了numBytes和offset，
# 则从offset处开始最多读numBytes个字节，另外如果指定了HEX参数，则内容会以十六进制形式存储在var变量中
file(READ filename var [LIMIT numBytes] [OFFSET offset] [HEX])

# 重命名文件
file(RENAME <oldname> <newname>)

# 删除文件， 等于rm命令
file(REMOVE [file1 ...])

# 递归的执行删除文件命令, 等于rm -r
file(REMOVE_RECURSE [file1 ...])

# 根据指定的url下载文件
# timeout超时时间; 下载的状态会保存到status中; 下载日志会被保存到log; sum指定所下载文件预期的MD5值,如果指定会自动进行比对，如果不一致，则返回一个错误; SHOW_PROGRESS，进度信息会以状态信息的形式被打印出来
file(DOWNLOAD url file [TIMEOUT timeout] [STATUS status] [LOG log] [EXPECTED_MD5 sum] [SHOW_PROGRESS])

# 创建目录
file(MAKE_DIRECTORY [dir1 dir2 ...])

# 会把path转换为以unix的/开头的cmake风格路径,保存在result中
file(TO_CMAKE_PATH path result)

# 它会把cmake风格的路径转换为本地路径风格：windows下用"\"，而unix下用"/"
file(TO_NATIVE_PATH path result)

# 将会为所有匹配查询表达式的文件生成一个文件list，并将该list存储进变量variable里, 如果一个表达式指定了RELATIVE, 返回的结果将会是相对于给定路径的相对路径, 查询表达式例子: *.cxx, *.vt?
NOTE: 按照官方文档的说法，不建议使用file的GLOB指令来收集工程的源文件
file(GLOB variable [RELATIVE path] [globbing expressions]...)

CMake常用变量

UNIX 如果为真，表示为 UNIX-like 的系统，包括 AppleOS X 和 CygWin
WIN32 如果为真，表示为 Windows 系统，包括 CygWin
APPLE 如果为真，表示为 Apple 系统
CMAKE_SIZEOF_VOID_P 表示 void* 的大小（例如为 4 或者 8），可以使用其来判断当前构建为 32 位还是 64 位
CMAKE_CURRENT_LIST_DIR 表示正在处理的CMakeLists.txt 文件的所在的目录的绝对路径（2.8.3 以及以后版本才支持）
CMAKE_ARCHIVE_OUTPUT_DIRECTORY 用于设置 ARCHIVE 目标的输出路径
CMAKE_LIBRARY_OUTPUT_DIRECTORY 用于设置 LIBRARY 目标的输出路径
CMAKE_RUNTIME_OUTPUT_DIRECTORY 用于设置 RUNTIME 目标的输出路径

简单的例子

新建一个Qt工程，没有做任何修改，在项目中添加 CMakeLists.txt 文件，编写完成之后按照下图配置以cmake编译
在这里插入图片描述

Qt Creator + CMake 构建教程
falwat的专栏
02-26 2578
Qt 6 以下的版本使用构建可能会存在一些问题。
CMake编译Qt
蜗牛档案室
09-16 5555
貌似有个CMake教程上说过“不要使用CMake编译Qt”，原因是Qt有自己的QMake，用CMake会费时费力，不过为了能把所有工程采用同样的编译方式，还是尝试了一下，的确很麻烦。 首先需要下载Qt SDK，因为打算用VS2010编译，所以下载了everywhere的4.7b2版本（注意：4.6.3不支持2010，强编会出错，4.7b2静态编译也会有同样的问题，估计正式版会有改善吧） 编译整体还是比较简单的 把VS目录下的vcvars32.bat复制到qt目录下 打开控制台，首先运行v
Qt Cmake编译
wangshan0908的博客
04-24 596
保证cmake已经安装且版本大于2.28等待执行完毕生成Project.exe。
用CMake构建Qt5的Visual Studio工程
weixin_30467087的博客
12-29 706
使用Visual Studio构建Qt工程的方法有很多种，可以使用Visual Studio自带的功能手动创建配置工程，也可以创建pro文件，然后通过VS的Qt插件导入进行创建。还有一种方式是通过CMake进行管理创建，需要注意的是Qt5和Qt4有区别，这里只讲Qt5。 #设置cmake版本号 cmake_minimum_required(VERSION 3.4.0) #设置工程名称...
(Qt) cmake编译Qt项目
cuber-lotus的博客
12-31 6203
通常我们在编写qt的时候都是在Qt creator中。而如何在VS Code中编写qt就是本文需要解决的问题。
qt 使用 cmake 创建插件（QPluginLoader 加载插件编译文件） 项目文件
04-07
qt 使用 cmake 创建插件（QPluginLoader 加载插件编译文件） 项目文件 说明 ： ...qt 6 c++ cmake qt_generate_deploy_script qt_standard_project_setup qt_add_library qt_add_plugin QGenericPlugin ...
windows下Qt6 使用CMake 安装时自动拷贝Qt及其他依赖文件
02-06
在Windows环境下，使用CMake构建Qt6项目时，往往需要处理Qt库和其他依赖文件的路径问题，确保在不同机器上运行程序时能够正确找到这些文件。这篇内容将深入讲解如何利用CMake配置过程来自动复制Qt及其依赖文件，以...
Qt VS CMake 编译qwindowkit
01-04
使用Qt和CMake编译qwindowkit的过程是一个系统性的工程，它要求开发者对Qt框架、CMake工具以及Visual Studio等开发工具有深入的理解和恰当的配置。正确的步骤加上细心的问题排查，将使得这个过程变得高效而顺畅。
Qt5.15静态编译+CMake构建+MSVC
qq_42123832的博客
03-31 3318
1. 环境 Qt: 5.15.2(静态编译)，怎么完成静态编译，网上有教程，此处不赘述 MSVC: VS2019 CMake: 3.19.0， 安装Qt时自动安装好的 2. Qt静态库目录 我编译的Qt5静态库版本是5.15.2，因此我将其拷贝到我的Qt安装目录下的 E:\Qt\5.15.2 位置中，并重命名为 static_msvc2019_64。 3. 设置静态库的kit(一般将怎么静态编译的文章都有讲) 请注意，这里的 Qt versions 一定要选择你静态编译的那个，否则编译出来的还是链接
QT用于CMake项目
12-09
QT用于CMake项目
CMake 生成Qt工程文件（vs2013 or vs2015）
12-11
CMake & Qt 开发 用CMake来生成和管理Qt代码，用visual studio 编译，本Sample编译后运行结果为最简单的QT对话框。
cmake开发环境 linux qt_Qt怎么使用cmake进行编译纪要
weixin_31184569的博客
01-13 886
Qt怎么使用cmake进行编译，首先安装cmake这个我就不多讲了，网上一搜一大堆。根据自身经历，将qmake工程转成cmake工程，怎么转换呢？下面是步骤：步骤：1：在项目目录下创建CMakeLists.txt文件，在这个文件中添加一些内容，内容参考.pro文件，下面有代码案例，朋友们可以参考。2：创建build文件夹。3：将原先的.pro文件删除。4：打开工程的时候，选择CMakeLists....
qt 利用cmake编译
weixin_41199566的博客
01-12 855
【代码】qt 利用cmake编译。
使用CMake进行Qt编译
KgCrystal的博客
10-07 1058
然后，我们设置了CMAKE_AUTOMOC和CMAKE_INCLUDE_CURRENT_DIR变量，以便CMake能够自动处理Qt的元对象编译和包含当前目录。接下来，使用find_package命令找到Qt5的Widgets组件，并将其添加为我们项目的依赖项。最后，使用add_executable命令指定要编译的源文件，并使用target_link_libraries命令将Qt5::Widgets库链接到我们的应用程序中。这将使用CMakeLists.txt文件中的配置选项生成项目的构建文件。
Cmake如何编译Qt程序
张懿的博客
06-09 5061
今天给大家讲解一下Cmake如何编译Qt程序。  这里说的Qt程序不只是用QtCreator写出来的程序，当然也可以是文本编辑器…。这里说的Qt程序是指，QCoreApplication，QApplication( QMainWindow，QWidget,QDialogue)类型的程序。 CMake是一个跨平台的非常通用的于编译器，用cmake命令可以生产出makefile，在利用make
【cmake】CMake编译Qt项目
qq_43331089的博客
11-17 2278
对于Qt项目，一般情况下使用qmake进行编译，但是在编译过程中会对源代码有一定程度上的改变，而使用CMake则没有这种烦恼，或者说比较简单的进行编译。
Qt工程CMake编译
Learning by doing
11-21 3490
cmake_minimum_required(VERSION 3.5.1) # https://blog.csdn.net/sinat_31964903/article/details/86615053 #指定Qt路径(按需设置) #SET(CMAKE_PREFIX_PATH C:/Qt/Qt5.7.0/5.7/msvc2013/lib/cmake) #list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake") proje...
Qt CMake
最新发布
03-28
<think>嗯，用户想知道如何在Qt项目中使用CMake进行构建配置。首先，我需要回忆一下CMake和Qt的结合使用方式。记得Qt官方现在推荐使用CMake，尤其是Qt6之后，QMake可能会逐渐被替代。用户提供的引用里也提到，当项目复杂度超过QMake处理能力时，CMake是更好的选择[^1]。所以首先需要明确Qt项目的基本结构，以及如何用CMake配置。 首先，安装Qt的时候需要确保安装了CMake相关的模块。然后，项目中的CMakeLists.txt需要正确配置Qt的模块。比如，要找到Qt的包，用find_package(Qt6 COMPONENTS Core Widgets REQUIRED)，然后链接到目标库。可能还要处理自动生成moc文件的问题，这需要设置AUTOMOC属性。 接下来，用户可能遇到如何处理资源文件，比如.qrc文件，或者UI文件。CMake需要知道如何处理这些，可能需要用qt_add_resources和qt_wrap_ui之类的命令。不过根据Qt6的文档，现在很多处理都是自动的，只要正确包含文件即可。 另外，引用中提到可以使用qt-cmake脚本来简化配置，这样不用手动设置CMAKE_PREFIX_PATH[^2]。这应该是在安装Qt时提供的脚本，位于bin目录下。用户可能需要运行类似qt-cmake ..的命令来配置项目，这样CMake会自动找到Qt的路径。 还有可能的问题是关于跨平台编译，比如在Windows和Linux之间切换。CMake的跨平台特性应该能处理这些，但可能需要不同的生成器，比如在Windows用Visual Studio，而在Linux用Makefile。用户提到的引用3中有关于替换路径来解决错误的例子，这可能涉及到路径设置的问题，需要确保CMake正确找到依赖库的路径，比如Dlib和OpenCV[^3]。 然后，可能需要处理一些特定的构建问题，比如动态链接和静态链接的区别。Qt默认是动态链接，但如果是静态构建，需要调整CMake的配置。同时，处理第三方库的集成也是一个挑战，需要确保find_package正确找到这些库，并链接到目标。 还有，用户可能会混淆CMake和QMake的语法，需要明确CMake的语法结构，比如使用target_link_libraries来链接Qt的库，而不是QMake的LIBS变量。此外，生成器表达式在CMake中可能用于处理不同配置，比如Debug和Release的不同库版本。 最后，测试配置是否正确，可以尝试构建一个简单的Qt项目，比如一个带有按钮的窗口，看看是否能正确编译运行。如果出现错误，检查CMake输出的信息，确认是否找到了所有必需的Qt模块，路径是否正确，以及是否启用了AUTOMOC等自动化处理步骤。</think>### 如何在Qt项目中使用CMake进行构建配置 #### 1. **基本配置步骤** - **步骤1：安装Qt和CMake** 确保已安装支持CMake的Qt版本（推荐Qt 5.15+或Qt6）。Qt安装时需勾选CMake支持组件。 - **步骤2：项目结构初始化** 创建`CMakeLists.txt`文件，并添加以下内容： ```cmake cmake_minimum_required(VERSION 3.16) project(MyQtProject) # 查找Qt库（以Qt6为例） find_package(Qt6 COMPONENTS Core Widgets REQUIRED) # 添加可执行文件 add_executable(MyApp main.cpp) # 链接Qt库并启用自动生成MOC文件 target_link_libraries(MyApp PRIVATE Qt6::Core Qt6::Widgets) set_target_properties(MyApp PROPERTIES AUTOMOC ON) ``` #### 2. **处理Qt特有资源** - **UI文件（`.ui`）和资源文件（`.qrc`）** 使用`qt_add_executable`（Qt6）或`qt_wrap_ui`（Qt5）命令处理UI文件： ```cmake # Qt6示例 qt_add_executable(MyApp SOURCES main.cpp UI_FILES mainwindow.ui RESOURCES resources.qrc ) ``` - **信号与槽的MOC处理** 通过设置`AUTOMOC`属性自动生成元对象代码： ```cmake set_target_properties(MyApp PROPERTIES AUTOMOC ON) ``` #### 3. **使用Qt提供的CMake脚本** Qt安装目录下的`qt-cmake`脚本可简化配置，避免手动设置`CMAKE_PREFIX_PATH`： ```bash # 在构建目录中运行 /path/to/Qt/bin/qt-cmake .. ``` #### 4. **跨平台编译注意事项** - **路径替换问题** 若集成第三方库（如Dlib/OpenCV），需检查路径是否正确。例如，引用[3]中提到需替换路径中的冗余目录`dlib-19.19.0\dlib`为`dlib-19.19.0`以解决编译错误[^3]。 - **生成器选择** 根据平台选择生成器（如Windows用`-G "Visual Studio 17 2022"`，Linux用`-G "Unix Makefiles"`）。 #### 5. **完整示例（Qt6 + CMake）** ```cmake cmake_minimum_required(VERSION 3.21) project(MyQtApp) find_package(Qt6 COMPONENTS Core Widgets REQUIRED) qt_add_executable(MyApp SOURCES main.cpp mainwindow.cpp HEADERS mainwindow.h RESOURCES icons.qrc UI mainwindow.ui ) target_link_libraries(MyApp PRIVATE Qt6::Core Qt6::Widgets) ``` --- ###
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值