【C++】CMake入门

CMake 是一个跨平台的构建系统生成工具,可以生成用于编译和链接应用程序的构建文件(如 Makefile 或 Visual Studio 工程文件)。

安装 CMake

Windows

  • 可以从 CMake官网 下载并安装 Windows 版本的 CMake。
  • 安装完成后,确保将 CMake 添加到系统 PATH 环境变量中。

Linux

bash 复制代码
sudo apt-get update
sudo apt-get install cmake

单个源文件项目

我们需要提供源文件和向CMake提供项目配置描述。该描述使用CMake完成,完整的文档可以在 https://cmake.org/cmake/help/latest/ 找到。

准备

创建一个简单的 C++ 项目,包含以下文件:

  • CMakeLists.txt
  • main.cpp

我们希望将 main.cpp 源代码编译为单个可执行文件:

cpp 复制代码
#include<iostream>
int main(){
    std::cout<<"Hello world"<<std::endl;
    return 0;
}

CMakeLists.txt

cmake 复制代码
# 设置CMake所需的最低版本。如果使用的CMake版本低于该版本,则会发出致命错误
cmake_minimum_required(VERSION 3.10)

# 声明了项目的名称(Test)和支持的编程语言(CXX代表C++)
project(Test CXX)

# 指示CMake创建一个新目标:可执行文件main。这个可执行文件是通过编译和链接源文件main生成的。CMake将为编译器使用默认设置,并自动选择生成工具
add_executable(main main.cpp)

生成

打开命令提示符,导航到项目目录,然后运行:

sh 复制代码
mkdir build
cd build
cmake ..

或者使用,具有相同效果:

sh 复制代码
# 该命令是跨平台的,使用了-H和-B为CLI选项。-H表示当前目录中搜索根CMakeLists.txt文件。-Bbuild告诉CMake在一个名为build的目录中生成所有的文件
cmake -H. -Bbuild

项目的配置已经在build目录中生成。我们现在可以编译可执行文件:

sh 复制代码
cmake --build .

切换生成器

CMake是一个构建系统生成器,可以使用单个CMakeLists.txt为不同平台上的不同工具集配置项目。您可以在CMakeLists.txt中描述构建系统必须运行的操作,以配置并编译代码。基于这些指令,CMake将为所选的构建系统(Unix Makefile、Ninja、Visual Studio等等)生成相应的指令。

  • Visual Studio 编译器 (MSVC) :适用于 Windows 系统,常用生成器是 NMake MakefilesVisual Studio.

  • MinGW 或 MSYS2 :适用于 Windows 系统,可以使用 MinGW Makefiles.

  • Unix Makefiles:适用于类 Unix 系统,例如 Linux 或 macOS。

    cmake -Bbuild -G "NMake Makefiles"

多个可执行文件和库项目

准备

目录结构如下:

mathematica 复制代码
MyProject/
├── include/
│   └── say.hpp
├── src/
│   ├── main.cpp
│   └── say.cpp
├── lib/
└── bin/
cpp 复制代码
# main.cpp

#include"say.hpp"
int main() {
    say();
    return 0;
}
cpp 复制代码
# say.cpp

#include<iostream>
#include"say.hpp"
void say(){
    std::cout<<"Hello world!"<<std::endl;
}
cpp 复制代码
# say.hpp

#pragma once
void say();

CMakeLists.txt

我们需要编写 CMakeLists.txt 文件来编译这些文件并链接库。

cmake 复制代码
# 指定 CMake 的最低版本要求
cmake_minimum_required(VERSION 3.10)

# 定义项目名称和版本
project(test VERSION 1.0.0)

# 设置 C++ 标准
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED True)

# 添加 include 目录到编译器的头文件搜索路径
include_directories(${CMAKE_CURRENT_SOURCE_DIR}/include)

# 设置库和可执行文件输出路径
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/lib)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/lib)
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/bin)

# 创建静态库目标
add_library(message
    STATIC # 若动态库则参数为SHARED
    ${CMAKE_CURRENT_SOURCE_DIR}/src/say.cpp
)

# 添加可执行文件
add_executable(test
    ${CMAKE_CURRENT_SOURCE_DIR}/src/main.cpp
)

# 链接静态/动态库到可执行文件
target_link_libraries(test say)

生成

打开命令提示符或终端,导航到项目根目录:

sh' 复制代码
cd Test

创建 build 目录并导航到其中:

sh 复制代码
mkdir build
cd build

运行 CMake 配置命令:

sh 复制代码
cmake ..

运行构建命令:

sh 复制代码
cmake --build .
相关推荐
DBWYX13 分钟前
c++项目 网络聊天服务器 实现;QPS测试
c++
小萌新上大分42 分钟前
SpringCloudGateWay
java·开发语言·后端·springcloud·springgateway·cloudalibaba·gateway网关
XYY3692 小时前
前缀和 一维差分和二维差分 差分&差分矩阵
数据结构·c++·算法·前缀和·差分
PacosonSWJTU2 小时前
python基础-13-处理excel电子表格
开发语言·python·excel
froginwe112 小时前
Perl 条件语句
开发语言
longlong int2 小时前
【每日算法】Day 16-1:跳表(Skip List)——Redis有序集合的核心实现原理(C++手写实现)
数据库·c++·redis·算法·缓存
24白菜头2 小时前
C和C++(list)的链表初步
c语言·数据结构·c++·笔记·算法·链表
啥都鼓捣的小yao2 小时前
利用C++编写操作OpenCV常用操作
开发语言·c++·opencv
灼华十一2 小时前
Golang系列 - 内存对齐
开发语言·后端·golang
程序媛学姐2 小时前
SpringRabbitMQ消息模型:交换机类型与绑定关系
java·开发语言·spring