[C] Начало работы с CMake

【C】Начало работы с CMake

2024-07-12

CMake — это кроссплатформенный инструмент создания системы сборки, который может создавать файлы сборки (например, файлы Makefile или файлы проектов Visual Studio) для компиляции и связывания приложений.

Установить CMake

Окна

Можно получить из Официальный сайт CMake Загрузите и установите версию CMake для Windows.
После завершения установки обязательно добавьте CMake в системную переменную среды PATH.

Линукс

sudo apt-get update
sudo apt-get install cmake
1
2

проект с одним исходным файлом

Нам необходимо предоставить исходные файлы и описание конфигурации проекта в CMake. Это описание выполнено с использованием CMake, полную документацию можно найти по адресу https://cmake.org/cmake/help/latest/.

Подготовить

Создайте простой проект C++, содержащий следующие файлы:

CMakeLists.txt
main.cpp

Мы хотим скомпилировать исходный код main.cpp в один исполняемый файл:

#include<iostream>
int main(){
    std::cout<<"Hello world"<<std::endl;
    return 0;
}
1
2
3
4
5

CMakeLists.txt

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

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

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

генерировать

Откройте командную строку, перейдите в каталог проекта и запустите:

mkdir build
cd build
cmake ..
1
2
3

Или используйте с тем же эффектом:

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

Конфигурация проекта уже есть.build созданный в каталоге. Теперь мы можем скомпилировать исполняемый файл:

cmake --build .
1

переключатель генератора

CMake — это генератор системы сборки, который может использовать один файл CMakeLists.txt для настройки проектов для разных наборов инструментов на разных платформах. В CMakeLists.txt вы описываете действия, которые ваша система сборки должна выполнить для настройки и компиляции вашего кода. На основе этих инструкций CMake сгенерирует соответствующие инструкции для выбранной системы сборки (Unix Makefile, Ninja, Visual Studio и т. д.).

Компилятор Visual Studio (MSVC): Подходит для систем Windows, обычно используются генераторы. NMake Makefiles илиVisual Studio.
МинГВ или MSYS2: Подходит для системы Windows, вы можете использовать MinGW Makefiles.
Файлы Unix Makefile: для Unix-подобных систем, таких как Linux или macOS.

cmake -Bbuild -G "NMake Makefiles"
1

Несколько исполняемых и библиотечных проектов

Подготовить

Структура каталогов следующая:

MyProject/
├── include/
│   └── say.hpp
├── src/
│   ├── main.cpp
│   └── say.cpp
├── lib/
└── bin/
1
2
3
4
5
6
7
8

# main.cpp

#include"say.hpp"
int main() {
    say();
    return 0;
}
1
2
3
4
5
6
7

# say.cpp

#include<iostream>
#include"say.hpp"
void say(){
    std::cout<<"Hello world!"<<std::endl;
}
1
2
3
4
5
6
7

# say.hpp

#pragma once
void say();
1
2
3
4

CMakeLists.txt

нам нужно написать CMakeLists.txt файлы для компиляции этих файлов и связывания с библиотекой.

# 指定 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)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

генерировать

Откройте командную строку или терминал и перейдите в корневой каталог проекта:

cd Test
1

создавать build каталог и перейдите к нему:

mkdir build
cd build
1
2

Запустите команду настройки CMake:

cmake ..
1

Запустите команду сборки:

cmake --build .
1

Обмен технологиями