技術共有

【C】CMake 入門

2024-07-12

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

CMake は、アプリケーションをコンパイルおよびリンクするためのビルド ファイル (Makefile や Visual Studio プロジェクト ファイルなど) を生成できるクロスプラットフォーム ビルド システム生成ツールです。

CMakeをインストールする

ウィンドウズ

  • から入手できます CMake公式サイト Windows バージョンの CMake をダウンロードしてインストールします。
  • インストールが完了したら、必ず 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 ソース コードを単一の実行可能ファイルにコンパイルします。

#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.
  • MinGW または MSYS2: Windows システムに適しており、使用できます。 MinGW Makefiles.
  • Unix メイクファイル: Linux や macOS などの Unix 系システムの場合。
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