【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 .
相关推荐
giao源7 分钟前
JAVA实现将富文本内容插入已有word文档并下载(dock4j+jsoup)
java·开发语言·word
努力也学不会java9 分钟前
【网络原理】 网络编程套接字
java·开发语言·网络·网络协议·tcp/ip·php
鑫—萍13 分钟前
C++——入门基础
c语言·开发语言·c++·学习·算法
溟洵17 分钟前
【C++ Qt】快速上手 显⽰类控件(Label、LCDNumber、ProcessBar、CalendarWidget)
开发语言·c++·qt
HvrI136 分钟前
【Harmony_Bug】forEach + asyncawait 的异步陷阱
开发语言·华为·bug·harmonyos·鸿蒙
半青年1 小时前
单例模式:全局唯一性在软件设计中的艺术实践
java·c++·python·单例模式
说码解字1 小时前
C++ RAII
开发语言·c++
zl_dfq2 小时前
C++ 之 【list的简介、list 的构造函数、iterator、容量操作、元素访问、增删查改与迭代器失效】
数据结构·c++
喵先生!2 小时前
C++中析构函数
开发语言·c++
qq_447663052 小时前
手写SpringMVC(基本框架)
java·开发语言