Condivisione della tecnologia

【C】Iniziare con CMake

2024-07-12

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

CMake è uno strumento di generazione di sistemi di compilazione multipiattaforma in grado di generare file di compilazione (come Makefile o file di progetto di Visual Studio) per compilare e collegare applicazioni.

Installa CMake

finestre

  • Può essere ottenuto da Sito ufficiale di CMake Scarica e installa la versione Windows di CMake.
  • Al termine dell'installazione, assicurati di aggiungere CMake alla variabile di ambiente PATH di sistema.

Linux

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

progetto di file sorgente singolo

Dobbiamo fornire i file sorgente e fornire la descrizione della configurazione del progetto a CMake. Questa descrizione viene eseguita utilizzando CMake, la documentazione completa è disponibile su https://cmake.org/cmake/help/latest/.

Preparare

Crea un semplice progetto C++ contenente i seguenti file:

  • CMakeLists.txt
  • principale.cpp

Vogliamo compilare il codice sorgente main.cpp in un unico file eseguibile:

#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

creare

Apri un prompt dei comandi, vai alla directory del progetto ed esegui:

mkdir build
cd build
cmake ..
  • 1
  • 2
  • 3

Oppure utilizzare, con lo stesso effetto:

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

La configurazione del progetto è già presentebuild generato nella directory. Ora possiamo compilare l'eseguibile:

cmake --build .
  • 1

generatore di interruttori

CMake è un generatore di sistemi di compilazione che può utilizzare un singolo CMakeLists.txt per configurare progetti per diversi set di strumenti su piattaforme diverse. Descrivi in ​​CMakeLists.txt le azioni che il tuo sistema di compilazione deve eseguire per configurare e compilare il tuo codice. Sulla base di queste istruzioni, CMake genererà le istruzioni corrispondenti per il sistema di compilazione selezionato (Unix Makefile, Ninja, Visual Studio, ecc.).

  • Compilatore di Visual Studio (MSVC): Adatto per sistemi Windows, lo sono i generatori comunemente usati NMake Makefiles OVisual Studio.
  • MinGW o MSYS2: Adatto per il sistema Windows, è possibile utilizzare MinGW Makefiles.
  • Makefile di Unix: Per sistemi simili a Unix come Linux o macOS.
cmake -Bbuild -G "NMake Makefiles"
  • 1

Più progetti eseguibili e librerie

Preparare

La struttura delle directory è la seguente:

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

dobbiamo scrivere CMakeLists.txt files per compilare questi file e collegarli alla libreria.

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

creare

Apri un prompt dei comandi o un terminale e vai alla directory principale del progetto:

cd Test
  • 1

creare build directory e raggiungila:

mkdir build
cd build
  • 1
  • 2

Esegui il comando di configurazione CMake:

cmake ..
  • 1

Esegui il comando di compilazione:

cmake --build .
  • 1