欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

CMake介绍及用法示例

程序员文章站 2024-03-14 11:10:34
...

本文主要CMake的相关知识及其用法示例。

1. 概述

在此引用CMake官网的描述,如下:

CMake is an open-source, cross-platform family of tools designed to build, test and package software. 

CMake is used to control the software compilation process using simple platform and compiler independent configuration files, and generate native makefiles and workspaces that can be used in the compiler environment of your choice. 

The suite of CMake tools were created by Kitware in response to the need for a powerful, cross-platform build environment for open-source projects such as ITK and VTK.

2. 用法示例

2.1 安装CMake

使用 yum 命令安装cmake,如下:

yum install cmake.x86_64

2.2 示例项目1

2.2.1 项目代码结构

在实际的项目中,会对项目的各个功能模块的源码文件部署合理的存放位置,以求项目代码模块的结构清晰、互不干扰。

本节介绍的示例项目的代码目录结构如下:

CMake介绍及用法示例

对于上述代码目录结构,说明如下(所有的源码文件内容会在后面展示):

  • cmake_test为项目文件夹,在该文件夹下保存所有的项目内容;
  • build目录用于存放使用CMake构建项目时生成的文件,cmake命令也是在build目录中执行的。默认情况下,build文件夹中不包含任何文件。
  • cmake_dir1和cmake_dir2文件夹表示两个功能独立的代码模块,这两个文件夹中包括的源码文件列表如下:
    CMake介绍及用法示例
  • cmake_dir1和cmake_dir2中的main.cpp为对应模块的功能实现文件;
  • cmake_dir1和cmake_dir2中的CMakeLists.txt是分别针对各自的源码模块编写的CMake配置文件;
  • CMakeLists.txt是此项目*的CMake配置文件,包括了构建项目时的一些总体设置;
  • include文件夹用于存放构建项目时调用的头文件;
    CMake介绍及用法示例
  • lib文件夹用于存放构建项目时依赖的共享库;
    CMake介绍及用法示例
  • obj文件夹用于存放生成的项目文件,如可执行的二进制文件或共享库等。默认情况下,obj文件夹中不包含任何文件。

2.2.2 项目代码内容

此项目所涉及到的代码内容如下,CMakeLists.txt 文件中各项配置的作用,参考文件中的注释。

【项目根目录(cmake_test)下】

CMakeLists.txt 内容如下:

# CMake版本要求
cmake_minimum_required(VERSION 2.8)

# 生成的可执行文件及共享库的存放位置 
# PROJECT_SOURCE_DIR表示项目的*目录
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/obj)
SET(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/obj)

# 头文件路径
include_directories(${PROJECT_SOURCE_DIR}/include)

# 共享库位置
LINK_DIRECTORIES(${PROJECT_SOURCE_DIR}/lib)

# 添加构建子目录
ADD_SUBDIRECTORY(cmake_dir1)
ADD_SUBDIRECTORY(cmake_dir2)

【cmake_dir1文件夹下】

CMakeLists.txt 内容如下:

# 遍历当前路径下的所有源文件,并将其添加到变量DIR_SRCS中
aux_source_directory(. DIR_SRCS)

# 添加名为cmake_test1的可执行文件,该文件会由变量DIR_SRCS中的源文件构建生成
add_executable(cmake_test1 ${DIR_SRCS})

# 设置依赖的共享库
target_link_libraries(cmake_test1 fileA)

main.cpp 内容如下:

#include "fileA.h"

int main()
{
    // 调用函数funA
    funA();

    return 0;
}

【cmake_dir2文件夹下】

CMakeLists.txt 内容如下:

# 遍历当前路径下的所有源文件,并将其添加到变量DIR_SRCS中
aux_source_directory(. DIR_SRCS)

# 添加名为cmake_test2的可执行文件,该文件会由变量DIR_SRCS中的源文件构建生成
add_executable(cmake_test2 ${DIR_SRCS})

# 设置依赖的共享库
target_link_libraries(cmake_test2 fileB)

main.cpp 内容如下:

#include "fileB.h"

int main()
{
    // 调用函数funB
    funB();

    return 0;
}

【include文件夹下】

fileA.h 内容如下:

#include <iostream>

using namespace std;

int funA();

fileB.h 内容如下:

#include <iostream>

using namespace std;

int funB();

【lib文件夹下】

项目构建时所依赖的共享库,分别为 libfileA.so 和 libfileB.so ,这两个共享库是由源文件 fileA.cpp 和 fileB.cpp 编译生成的。需要说明的是,在实际的项目开发中,生成共享库的源文件可能不会提供,此处提供源文件,仅是方便大家编译生成项目构建时依赖的共享库。

fileA.cpp 内容如下:

#include "fileA.h"

int funA()
{
    cout << "This is funA in fileA print out!" << endl;

    return 0;
}

fileB.cpp 内容如下:

#include "fileB.h"

int funB()
{
    cout << "This is funB in fileB print out!" << endl;

    return 0;
}

2.2.3 项目构建

按照以下步骤,使用CMake进行项目构建:

1. 进入项目的build目录中:

CMake介绍及用法示例

2. 执行 cmake 命令,生成项目的makefile文件(生成的项目makefile会存放在build目录中):

CMake介绍及用法示例

说明:由于我们的项目*CMake配置文件CMakeLists.txt位于项目根目录cmake_test下,所以在build文件夹中执行cmake命令时,需要后接“..”来指定该CMakeLists.txt的位置。

3. (由于上一步已生成了makefile文件,所以此处)执行 make 命令,进行项目构建:

CMake介绍及用法示例

4. 因为在CMakeLists.txt中配置了生成的可执行文件的存放位置(即cmake_test/obj),所以此处进入obj文件夹中,查看是否生成了可执行文件:

CMake介绍及用法示例

5. 分别运行构建生成的可执行文件 cmake_test1 和 cmake_test2 ,结果如下:

CMake介绍及用法示例

上面的结果说明我们的项目构建成功、生成的可执行文件功能正常。

 

 

 

相关标签: CMake