用CMake管理自己的程序(二)

本文是关于如何使用CMake管理C++库项目的教程,内容涵盖创建库程序、使用库、处理编译时宏定义及解决乱码问题。通过CMakeLists.txt文件的配置,介绍了add_library、target_compile_definitions、include_directories、link_directories等关键命令的用法,帮助开发者更好地理解和应用CMake。

前言

上一篇文章用CMake管理自己的程序(一)中,我们简单的了解了一下要如何编写一个CMakeLists.txt文件。主要是介绍了一个Qt程序如何使用CMake进行管理。但是我们只说明了一个可执行程序怎么搞,接下来,就让我们继续,说一下库文件怎么办。

一个库程序

在这里插入图片描述
这是使用QtCreator新建一个库项目后自动生成的CMakeList.txt文件,相比可执行程序可谓是简单明了许多。这里我们可以忽略掉那连续两个find_package命令,因为无论你写多少个,最终的结果是不会发生变化的,这里写两个应该只是为兼容Qt5和Qt6罢了,略过不提。
于是,和上一篇做一个对比,我们就发现了两个主要的不同之处:
add_library命令target_complile_definitions命令
前者,就是要告诉cmake,我们现在要生成的不是可执行程序,而是一个库文件,并且是共享库。
后者,则是要在编译的时候,指定一个额外的“宏定义”ADD_LIBRARY。
用过Qt的都知道,Qt在生成库工程的时候,总会额外附加一个xxx_global.h文件,例如我们的例子中,这个文件长这样:
xxx_global.h
很显然,这个文件的目的,就是为了让库的头文件,在不同的工程中产生不同的效果。
在定义了ADD_LIBRARY这个宏的工程中(也就是本工程)

### 如何使用 Qt 和 CMake 管理程序结构 在现代软件开发中,使用 CMake 和 Qt 结合可以高效地管理复杂的程序结构。以下是如何通过 CMake 来组织和构建一个基于 Qt 的项目。 #### 1. 基础概念 CMake 是一个跨平台的构建工具,用于生成 Makefile 或工程文件,从而简化构建流程[^1]。Qt 提供了 qmake 工具来管理 Qt 项目的构建过程,但随着项目的复杂性增加,CMake 成为了更灵活的选择[^3]。 #### 2. CMakeLists.txt 文件配置 CMake 使用 `CMakeLists.txt` 文件来描述项目的结构和依赖关系。以下是配置 Qt 项目的基本步骤: - **设置最低版本要求** 首先需要指定 CMake 的最低版本要求,确保兼容性。 ```cmake cmake_minimum_required(VERSION 3.15) ``` - **定义项目名称** 定义项目的名称和编程语言。 ```cmake project(MyQtProject LANGUAGES CXX) ``` - **查找 Qt 模块** 使用 `find_package` 命令加载 Qt 模块。例如: ```cmake find_package(Qt5 COMPONENTS Core Widgets REQUIRED) ``` - **添加可执行文件** 使用 `add_executable` 添加主程序文件,并将源文件列出。 ```cmake add_executable(${PROJECT_NAME} main.cpp mainwindow.cpp mainwindow.h) ``` - **链接 Qt 库** 将 Qt 的库与目标链接起来。 ```cmake target_link_libraries(${PROJECT_NAME} PRIVATE Qt5::Core Qt5::Widgets) ``` #### 3. 引入资源文件(qrc) 如果项目中有资源文件(如图片、图标等),可以通过 `qt5_add_resources` 命令将其编译为 C++ 代码[^2]。 ```cmake set(RESOURCES resources.qrc) qt5_add_resources(QRC_RESOURCES ${RESOURCES}) add_executable(${PROJECT_NAME} main.cpp mainwindow.cpp mainwindow.h ${QRC_RESOURCES}) ``` #### 4. 引入第三方库 若项目需要引入第三方库,可以使用 `link_directories` 或 `target_link_libraries` 来指定库路径和链接库文件[^5]。 ```cmake link_directories(/path/to/thirdparty/libs) target_link_libraries(${PROJECT_NAME} PRIVATE thirdpartylib) ``` #### 5. 组织多模块项目 对于大型项目,可以将不同功能模块分离到不同的子目录中,并通过 `add_subdirectory` 命令引入。 ```cmake add_subdirectory(modules/module1) add_subdirectory(modules/module2) ``` #### 6. 完善构建规则 通过 `target_*` 系列命令,可以进一步完善构建规则,例如指定头文件路径、编译选项等[^4]。 ```cmake target_include_directories(${PROJECT_NAME} PRIVATE ${PROJECT_SOURCE_DIR}/include) target_compile_options(${PROJECT_NAME} PRIVATE -Wall -Wextra) ``` ### 示例代码 以下是一个完整的 `CMakeLists.txt` 示例: ```cmake cmake_minimum_required(VERSION 3.15) project(MyQtProject LANGUAGES CXX) # 查找 Qt 模块 find_package(Qt5 COMPONENTS Core Widgets REQUIRED) # 添加资源文件 set(RESOURCES resources.qrc) qt5_add_resources(QRC_RESOURCES ${RESOURCES}) # 添加可执行文件 add_executable(${PROJECT_NAME} main.cpp mainwindow.cpp mainwindow.h ${QRC_RESOURCES} ) # 链接 Qt 库 target_link_libraries(${PROJECT_NAME} PRIVATE Qt5::Core Qt5::Widgets) # 引入第三方库 link_directories(/path/to/thirdparty/libs) target_link_libraries(${PROJECT_NAME} PRIVATE thirdpartylib) ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值