CMakeを初めて使ってみる(実行ファイル、静的ライブラリ、動的ライブラリ)

はじめに

今回はCMakeを初めて触ってみるという記事です。

CMake is a tool to manage building of source code. Originally, CMake was designed as a generator for various dialects of Makefile, today CMake generates modern buildsystems such as Ninja as well as project files for IDEs such as Visual Studio and Xcode.

CMake Reference Documentation — CMake 3.24.0-rc1 Documentation

// DeepL翻訳
CMakeはソースコードのビルドを管理するためのツールです。元々、CMakeは様々なMakefileの方言の生成ツールとして設計されましたが、今日ではNinjaのような最新のビルドシステムや、Visual StudioやXcodeのようなIDE用のプロジェクトファイルの生成も行っています。

最初に言っておくと、私自身まだ分かっていないことが多くかなり自己満足的な記事になっているのであしからず。

• はじめに
• インストール
• 準備
• お手製ビルド
  • オブジェクトファイル生成
  • 実行ファイル生成
  • ソースコードから実行ファイルを生成する
• CMakeを使ったビルド
  • 実行ファイルの生成
• 静的ライブラリの作成
• 動的ライブラリの作成
• ひとこと

インストール

Homebrewを使える環境ならば以下のコマンドを打つだけです。

$ brew install cmake

準備

以下のファイルを用意しました

.
|--- sample.hpp
|--- sample.cpp
|--- main.cpp

// sample.hpp
#ifndef SAMPLE_H
#define SAMPLE_H

void method();

#endif

// sample.cpp
#include <iostream>
#include "sample.hpp"

void method(){
    std::cout << "Hello, World!" << std::endl;
}

// main.cpp
#include "sample.hpp"

int main(){
    method();
}

お手製ビルド

まずはCMakeを利用せずに自分でg++を利用してビルドを行ってみます。

g++ -c main.cpp sample.cpp

.
|--- sample.hpp
|--- sample.cpp
|--- sample.o
|--- main.cpp
|--- main.o

$ g++ -o a.out main.o sample.o

.
|--- sample.hpp
|--- sample.cpp
|--- sample.o
|--- main.cpp
|--- main.o
|--- a.out

$ ./a.out
Hello, World!

ソースコードから実行ファイルを生成する

.oを毎回生成するのも面倒ですが、以下のようなコマンドを打てばソースコードから一気に実行ファイルが生成されます。

$ g++ main.cpp sample.cpp

CMakeを使ったビルド

CMakeを利用するには、CMakeLists.txtというテキストを作成する必要があるそうです。

# CMakeのバージョン設定
cmake_minimum_required(VERSION 2.8)

# a.outという実行ファイルをmain.cppとsample.cppから作成
add_executable(a.out main.cpp sample.cpp)

$ cmake -S . -B build
$ cmake --build build

.
|--- sample.hpp
|--- sample.cpp
|--- main.cpp
|--- CMakeLists.txt
|--- build
      |--- a.out
      |--- その他もろもろ

静的ライブラリの作成

# CMakeのバージョン設定
cmake_minimum_required(VERSION 2.8)

#sample.cppから動的ライブラリを生成する
add_library(mylib STATIC sample.cpp)

Mac上では.aが生成されました。

.
|--- sample.hpp
|--- sample.cpp
|--- main.cpp
|--- CMakeLists.txt
|--- build
      |--- libmylib.a
      |--- その他もろもろ

動的ライブラリの作成

# CMakeのバージョン設定
cmake_minimum_required(VERSION 2.8)

#sample.cppから動的ライブラリを生成する
add_library(mylib SHARED sample.cpp)

Mac上では.dylibが生成されました。

.
|--- sample.hpp
|--- sample.cpp
|--- main.cpp
|--- CMakeLists.txt
|--- build
      |--- libmylib.dylib
      |--- その他もろもろ

ひとこと

今回は本当に触りの部分しかできていませんが、一応iOS用のstatic library作成あたりもやりたいと思っているのでまた関連の記事を書くかもです。