[C] Erste Schritte mit CMake

【C】Erste Schritte mit CMake

2024-07-12

CMake ist ein plattformübergreifendes Build-System-Generierungstool, das Build-Dateien (z. B. Makefiles oder Visual Studio-Projektdateien) zum Kompilieren und Verknüpfen von Anwendungen generieren kann.

Installieren Sie CMake

Windows

Erhältlich bei Offizielle CMake-Website Laden Sie die Windows-Version von CMake herunter und installieren Sie sie.
Stellen Sie nach Abschluss der Installation sicher, dass Sie CMake zur Systemumgebungsvariablen PATH hinzufügen.

Linux

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

Single-Source-Dateiprojekt

Wir müssen CMake Quelldateien und eine Beschreibung der Projektkonfiguration bereitstellen. Diese Beschreibung erfolgt mit CMake. Die vollständige Dokumentation finden Sie unter https://cmake.org/cmake/help/latest/.

Vorbereiten

Erstellen Sie ein einfaches C++-Projekt mit den folgenden Dateien:

CMakeLists.txt
main.cpp

Wir möchten den main.cpp-Quellcode in eine einzige ausführbare Datei kompilieren:

#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

generieren

Öffnen Sie eine Eingabeaufforderung, navigieren Sie zum Projektverzeichnis und führen Sie Folgendes aus:

mkdir build
cd build
cmake ..
1
2
3

Oder verwenden Sie mit dem gleichen Effekt:

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

Die Projektkonfiguration ist bereits vorhandenbuild im Verzeichnis generiert. Wir können jetzt die ausführbare Datei kompilieren:

cmake --build .
1

Generator umschalten

CMake ist ein Build-System-Generator, der eine einzige CMakeLists.txt verwenden kann, um Projekte für verschiedene Toolsets auf verschiedenen Plattformen zu konfigurieren. Sie beschreiben in CMakeLists.txt die Aktionen, die Ihr Build-System ausführen muss, um Ihren Code zu konfigurieren und zu kompilieren. Basierend auf diesen Anweisungen generiert CMake entsprechende Anweisungen für das ausgewählte Build-System (Unix Makefile, Ninja, Visual Studio usw.).

Visual Studio-Compiler (MSVC): Geeignet für Windows-Systeme, häufig verwendete Generatoren NMake Makefiles oderVisual Studio.
MinGW oder MSYS2: Geeignet für Windows-Systeme, die Sie verwenden können MinGW Makefiles.
Unix Makefiles: Für Unix-ähnliche Systeme wie Linux oder macOS.

cmake -Bbuild -G "NMake Makefiles"
1

Mehrere ausführbare und Bibliotheksprojekte

Vorbereiten

Die Verzeichnisstruktur ist wie folgt:

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

wir müssen schreiben CMakeLists.txt Dateien, um diese Dateien zu kompilieren und mit der Bibliothek zu verknüpfen.

# 指定 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

generieren

Öffnen Sie eine Eingabeaufforderung oder ein Terminal und navigieren Sie zum Projektstammverzeichnis:

cd Test
1

erstellen build Verzeichnis und navigieren Sie dorthin:

mkdir build
cd build
1
2

Führen Sie den CMake-Konfigurationsbefehl aus:

cmake ..
1

Führen Sie den Build-Befehl aus:

cmake --build .
1

Technologieaustausch