文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

大型工程的管理,CMake快速入门

2024-11-30 02:17

关注

我们先从一个最简单的场景开始,这种场景就是只有一个源文件的场景。当然,对于单文件的场景我们可以直接通过gcc进行编译,但是为了说明CMake的用法,我们以此作为起点。后面我们会逐步介绍更加复杂的场景。目的很简单,主要是为了降低入门的门槛,然后让大家像上台阶一样,不知不觉的爬到泰山之巅。

单文件的软件工程

我们可以先创建一个目录,比如simple,然后在这个目录中创建一个名称为main.cpp的C++程序,程序代码如下所示。

#include 
int main(int argc, char** argv)
{
    std::cout << "this is a simple example!" << "\n";
    return 0;
}

再创建一个名称为CMakeLists.txt的文件,这个文件正是cmake使用的文件。文件的内容如下,是不是很简单。

cmake_minimum_required(VERSION 3.16)

project(CMakeSunny
      VERSION 1.0
      DESCRIPTION "A CMake Tutorial"
      LANGUAGES CXX)

add_executable(cmlearn
                           main.cpp)

上面文件中cmake_minimum_required用于指定cmake的最低版本号。project用于名称功能,其中包含工程名称、版本信息和工程描述等信息。最后add_executable则用于指定编程后的可执行文件名称以及源代码文件。

具备上述两个文件后,在根目录下面创建一个名称为build的目录,然后切换到目录下面,执行cmake就可以生成一个Makefile文件。然后执行make命令就可以编译出二进制文件来。具体执行的命令如下:

mkdir build
cd build
cmake ..
make

下图展示了上述文件的关系,main.cpp和CMakeLists.txt是我们创建的。目录build中的目录和文件分别是通过cmake和make命令生成的。最终生成的二进制文件也是在build目录中,名称为cmlearn,这个名称是在CMakeLists.txt定义的。

多文件的软件工程

更进一步,如果我们的软件工程通常包含不止一个文件,比如我们这里增加一个做加法的函数,这个函数在一个独立的文件中。此时工程中包含3个独立的文件,分别为main.cpp、add.cpp和头文件add.h。此时我们自己创建的文件目录结构如下图所示。

接下来我们只需要做很简单的改动就可以将新文件的内容编译进来。如下代码所示,我们在add_executable中添加add.cpp文件即可。

cmake_minimum_required(VERSION 3.16)
project(CMakeSunny
    VERSION 1.0
    DESCRIPTION "A CMake Tutorial"
    LANGUAGES CXX)

add_executable(add
    main.cpp
    add.cpp)

上述add.cpp文件的内容如下所示,其功能很简单,就是实现一个加法功能。

int add(int a, int b)
{
    return a+b;
}

头文件的实现更加简单,具体内容如下所示。需要注意的是,我们这里仅仅是为了延时CMake的功能,很多产品级必须的代码名没有写到这里。

int add(int a, int b);

为了验证实现的正确性,我们可以在main.cpp中做一些修改,引用在add.cpp中实现的函数。具体修改后的内容如下所示。

#include 
#include "add.h"

int main(int argc, char** argv)
{
    int r = add(1, 3);
    std::cout << "this is a simple example!" << r << "\n";
    return 0;
}

完成上述修改后,大家可以切回到build目录中,重新执行cmake ..和make命令,可以看到生成了新的二进制文件cmlearn。我们可以执行一下这个程序,可以看到结果符合预期。

包含子目录的软件工程

实际的大型项目比上面介绍的还要复杂的多。比如上文我们提到实现了一个加法功能的add.cpp文件。比如我们又要实现减法、乘法和除法等功能,也都是在独立的文件中实现。那么这些计算的实现最好放到一个目录中,比如math目录。在大型项目中经常会这样组织源代码,一个功能模块的代码,或者详细功能的代码被组织在一个子目录中。

这是源代码会被组织成如下图所示的结构,而且在子目录math中也需要新建一个名称为CMakeLists.txt文件。该文件的内容可以非常简单,具体如下所示,是不是很简单!

add_library(math OBJECT sub.cpp
                                          add.cpp)

函数add_library用于创建一个库,这里的库与Linux的动态库和静态库的概念基本对应,但不完全一样。本例是创建一个OBJECT类型的库,其实就是生成目标文件。如前文所述,这个函数可以创建Linux的动态库和静态库,我们后面会详细介绍一下这方面的内容。

如下是该函数的几种应用场景,比如STATIC是静态库,SHARED是动态库,OBJECT则是我们当前使用的目标文件。另外还有MODULE、INTERFACE和IMPORTED等类型。

add_library( [STATIC | SHARED | MODULE]
    [EXCLUDE_FROM_ALL]
    [...])
add_library( OBJECT [...])
add_library( INTERFACE)
add_library(  IMPORTED [GLOBAL])

有了子目录中的CMakeLists.txt还不够,我们需要在根目录的CMakeLists.txt添加一些内容,建立根目录与子目录math的联系。建立联系很简单,我们只需要在根目录的CMakeLists.txt中添加如下一行代码即可。

add_subdirectory(math)

当添加上述代码后,我们在build目录再次执行cmake命令的时候可以触发子目录生成Makefile文件。而执行make命令进行编译的时候,可以触发子目录的编译,生成目标文件。

target_link_libraries(cmlearn PUBLIC math)

上述函数实现了链接的功能,将子模块math链接到了主模块main上,最终会生成一个可执行程序。但是我们在源代码层面还没有任何更该,主程序也没有调用add.cpp和sub.cpp中的任何函数,所以实际上也不存在链接的过程。

如果让主程序调用math中的函数,首先需要在主程序中包含头文件。在CMakeLists.txt中需要添加如下代码来告诉编译器头文件的位置。否则在编译的时候会有找不到头文件的错误提示。

target_include_directories(cmlearn PUBLIC
    "${PROJECT_SOURCE_DIR}/math"
)

完成CMakeLists.txt的修改后,我们最后需要修改一下主程序。修改主程序的目的主要是让主程序调用math中实现的函数。修改后的主程序如下所示,在主程序中调用了add和sub两个函数,并且在一开始包含了add.h和sub.h两个文件。

#include 
#include "add.h"
#include "sub.h"

int main(int argc, char** argv)
{
    int sum = add(1, 3);
    int diff = sub(3, 1);
    std::cout << "The sum of 1 and 3 is " << sum << std::endl;
    std::cout << "The diff of 3 and 1 is " << diff << std::endl;
    return 0;
}

完成上述修改后,我们可以在build目录执行“cmake ..”命令,然后执行make命令编译程序,最后可以得到一个可执行程序。

通过上面的举例,我们对通过CMake来维护一个大型的软件项目有了一个初步的了解。实际上CMake实现的功能还要丰富的多, 我们在后续会详细介绍。

来源:今日头条内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯