day01 CMake学习记录

发布时间:2024年01月12日

? ? ? ?Make 工具有很多,例如 GNU Make ,QT 的 qmake ,微软的 MS nmake,BSD Make,Makepp等等。这些 Make 工具遵循着不同的规范和标准,所执行的 Makefile 格式也千差万别。这样就带来了一个严峻的问题:如果软件想跨平台,必须要保证能够在不同平台编译。而如果使用上面的 Make 工具,就得为每一种标准写一次 Makefile ,这将是一件让人抓狂的工作。

? ? ? ?CMake 就是针对上述问题所设计的工具:它首先允许开发者编写一种平台无关的 CMakeList.txt 文件来定制整个编译流程,然后再根据目标用户的平台进一步生成所需的本地化 Makefile 和工程文件,如 Unix 的 Makefile 或 Windows 的 Visual Studio 工程。从而做到“Write once, run everywhere”。

在 linux 平台下使用 CMake 生成 Makefile 并编译的流程如下:

  1. 写 CMake 配置文件 CMakeLists.txt 。
  2. 执行命令?cmake PATH?或者?ccmake PATH?生成 Makefile(ccmake?和?cmake?的区别在于前者提供了一个交互式的界面)。其中,?PATH?是 CMakeLists.txt 所在的目录。
  3. 使用?make?命令进行编译。

A Basic Starting Point (Step 1)

最基本的就是将一个源代码文件编译成一个exe可执行程序。对于一个简单的工程来说,两行的CMakeLists.txt文件就足够了。这将是我们教程的开始。CMakeLists.txt文件看起来会像这样:

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)

# 项目信息
project (Demo)

# 指定生成目标
add_executable(Demo test.cxx)

注意,在这个例子中,CMakeLists.txt都是使用的小写字母。事实上,CMake命令是大小写不敏感的,你可以用大写,也可以用小写,也可以混写。

多个源文件

▌同一目录,多个源文件

./Demo
    |
    +--- main.cpp
    |
    +--- Functions.cpp
    |
    +--- Functions.h

这个时候,CMakeLists.txt 可以改成如下的形式:

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)

# 项目信息
project (Demo)

# 指定生成目标
add_executable(Demo main.cpp Functions.cpp)

这样写当然没什么问题,但是如果源文件很多,把所有源文件的名字都加进去将是一件烦人的工作。更省事的方法是使用?aux_source_directory?命令,该命令会查找指定目录下的所有源文件,然后将结果存进指定变量名。其语法如下:

aux_source_directory(<dir> <variable>)

因此,可以修改 CMakeLists.txt 如下:

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)

# 项目信息
project (Demo)

# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_SRCS 变量
aux_source_directory(. DIR_SRCS)

# 指定生成目标
add_executable(Demo ${DIR_SRCS})

▌多个目录,多个源文件

./Demo
    |
    +--- main.cpp
    |
    +--- Test/
          |
          +--- Functions.cpp
          |
          +--- Functions.h

对于这种情况,需要分别在项目根目录 Demo 和 Test?目录里各编写一个 CMakeLists.txt 文件。为了方便,我们可以先将 Test 目录里的文件编译成静态库再由 main 函数调用。根目录中的 CMakeLists.txt :

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)

# 项目信息
project (Demo)

# 添加 Test 子目录
add_subdirectory(Test)

# 指定生成目标 
add_executable(Demo main.cpp)

# 添加链接库
target_link_libraries(Demo Functions)

该文件添加了下面的内容: 第3行,使用命令?add_subdirectory?指明本项目包含一个子目录 Test,这样 Test 目录下的 CMakeLists.txt 文件和源代码也会被处理 。第6行,使用命令?target_link_libraries?指明可执行文件 main 需要连接一个名为 Functions 的链接库 。子目录中的 CMakeLists.txt:

# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_LIB_SRCS 变量
aux_source_directory(. DIR_LIB_SRCS)

# 生成链接库
add_library (Functions ${DIR_LIB_SRCS})

在该文件中使用命令?add_library?将 src 目录中的源文件编译为静态链接库。

文章来源:https://blog.csdn.net/m0_59275036/article/details/135539542
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。