Technologieaustausch

【C】Erste Schritte mit CMake

2024-07-12

한어Русский языкEnglishFrançaisIndonesianSanskrit日本語DeutschPortuguêsΕλληνικάespañolItalianoSuomalainenLatina

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