ビルド自動化ツールCMake Part.1

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 20:08:31.78

CMakeは、コンパイラに依存しないビルド自動化のためのフリーソフトウェアです。主にC/C++のビルド管理で使用され、様々なビルド環境に対応しています。Windows、Linux、MacどこでもOK。

https://cmake.org/

基本的な使い方はまず、ビルド環境にCMakeをインストールした後で、ビルド方法を記述したテキストファイルCMakeList.txtをソースと同じ場所に作成した上で、
cmakeをジェネレータを指定して実行するとMakefileやプロジェクトファイルなどが生成されるので、それを使ってビルドします。
ジェネレータの一覧は-Gオプションを付けてcmakeを実行すると見られます。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 20:27:30.69

CMakeLists.txtの標準的な記述方法は以下の通りです。

【ここから】
# CMakeLists.txt --- CMake project settings
# ex) cmake -G "Visual Studio 9 2008" .
# ex) cmake -DCMAKE_BUILD_TYPE=Release -G "MinGW Makefiles" .
##############################################################################

# CMake minimum version
cmake_minimum_required(VERSION 3.0)

# project name and languages
project(MyProject C CXX)

##############################################################################

# program.exe
add_executable(program file1.cpp file2.cpp)

##############################################################################
【ここまで】

「#」で始まる行はコメントです。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 20:30:21.33

Win32アプリの場合のCMakeLists.txtの記述方法は以下の通りです。

【ここから】
# CMakeLists.txt --- CMake project settings
# ex) cmake -G "Visual Studio 9 2008" .
# ex) cmake -DCMAKE_BUILD_TYPE=Release -G "MinGW Makefiles" .
##############################################################################

# CMake minimum version
cmake_minimum_required(VERSION 3.0)

# project name and languages
project(MyProject C CXX RC)

##############################################################################

# program.exe
add_executable(program WIN32 file1.cpp file2.cpp program_res.rc)
target_link_libraries(program comctl32)

##############################################################################
【ここまで】

Win32の場合は「RC」と「WIN32」を付けるのを忘れないで下さい。

テンプレここまで。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 20:42:39.14

>>1
訂正。CMakeLists.txtです。Listsは複数形です。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 22:27:30.80

質問1. なぜMakefileを直接使わないの？
答え. Makefileには方言があって機種依存になっているため、あっちのMakefileがこっちで動かないことが多く、
開かれた幅広いサポートには不向きです。また、ビルドに関係ない記述も多く、移植作業の無駄になります。
CMakeはマルチプラットフォーム対応を少ない作業で実現します。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 22:39:16.78

質問2. ジェネレータって何ですか？
答え. ジェネレータとは何かのデータを生成する「生成器」のことです。
CMakeではビルド環境に対応したジェネレータを選ぶことでビルドができる
ようになります。以下はジェネレータの例です（環境によって異なります）：

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community>"C:\Program Files\CMake\bin\cmake.exe" -G
CMake Error: No generator specified for -G

Generators
* Visual Studio 16 2019 = Generates Visual Studio 2019 project files.
Use -A option to specify architecture.
...
Visual Studio 9 2008 [arch] = Generates Visual Studio 2008 project files.
Optional [arch] can be "Win64" or "IA64".
Borland Makefiles = Generates Borland makefiles.
NMake Makefiles = Generates NMake makefiles.
NMake Makefiles JOM = Generates JOM makefiles.
MSYS Makefiles = Generates MSYS makefiles.
MinGW Makefiles = Generates a make file for use with
...

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 22:45:32.10

質問3. Visual Studioでビルドしたい場合はどうすればいいですか？
答え. Visual Studioをインストールした場合は、Visual Studio専用の
コマンドプロンプトがWindowsメニューのプログラムリストの中にあります。
VSコマンドプロンプトを起動して、CDコマンドでソースのあるフォルダに
移動して、cmakeを実行して下さい。NMakeを使う方法と
VSソリューションファイルを使う方法の2種類あります。

cmake -G "NMake Makefiles" .
cmake -G "Visual Studio 16 2019" -A Win32 .
cmake -G "Visual Studio 9 2008 Win64" .

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 23:01:14.67

質問4. ビルドを自動化できると何かいいことあるの？
答え. GitHub Actionsなどと組み合わせて退屈なビルド・テスト作業を
自動化すると、人間がしなくていい無駄な仕事がなくなります。

GitHubでコミットしたときに複数の環境で自動ビルド・テストするようにすると、
人間はテスト結果の一覧を見るだけで次のコーディングに進むことができます。
CMakeは自動化・省力化を強力に支援します。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 23:17:00.91

自動化するには、バッチ処理や設定などの記述が必要ですが、一度正しく記述できれば、後はクラウド・仮想化・自動化のパワーで
圧倒的な開発手順の革新となります。そのパワーは開発規模が大きいほど効果的です。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 23:27:34.46

質問4. CMakeを扱うにはどんな知識・技術が必要？
答え.まず、コマンドプロンプトやシェルスクリプトを少し操れて、コマンドラインやバッチ処理が記述できる程度の技術が必要です。
また、CMakeの記述方法を自分で英語などでウェブ検索して情報を突き止める的確な検索技能が必要になります。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/12(土) 23:36:59.18

例えばCMakeで実行ファイルを作成するには「add_executable」というCMakeコマンドを使用しますが、これの使い方を検索して記述方法を3分の1でも理解できるようなレベルでなければいけません。
ライブラリを作成するには「add_library」というCMakeコマンドを使用します。こういったCMakeコマンドの並びをCMakeLists.txtというファイルに実際に記述するわけです。

**デフォルトの名無しさん** · 2021/06/13(日) 00:59:20.97

add_testってgoogle testとか外部テストライブラリ使わなくても使用可能なの？

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/13(日) 01:06:36.03

>>12
CMakeに付属するテストツールCTestを使うにはenable_testing()を書かないといけないらしい。

https://qiita.com/mrk_21/items/25ee7f00cebb9934b472

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/13(日) 01:11:13.33

CMakeをインストールしてれぱCTestも入ってるはず。

**デフォルトの名無しさん** · 2021/06/13(日) 01:37:26.49

>>12
常識的に考えてフレームワークは有ったほうが良いと思います。

**デフォルトの名無しさん** · 2021/06/13(日) 02:01:13.11

「はず」ねえ

**デフォルトの名無しさん** · 2021/06/13(日) 03:36:45.96

蟻人間の説明に誤りが多い。このスレは伸びない

**デフォルトの名無しさん** · 2021/06/13(日) 07:19:07.18

CMakeLists.txtの変数の一覧はどこかで見れる？

**デフォルトの名無しさん** · 2021/06/13(日) 09:43:26.14

完走出来るかはさておき次スレではビルドツール共用で

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/13(日) 09:57:10.24

>>18
「cmake variables」で検索すれば次のページが出てくる：
https://cmake.org/cmake/help/latest/manual/cmake-variables.7.html

**デフォルトの名無しさん** · 2021/06/13(日) 13:16:26.94

CMakeのプロジェクトのなかで変数一覧が記載されたファイルとかないの？

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/13(日) 13:59:51.46

>>21
cmakeに成功すると、CMakeCache.txtというファイルができる。
この中に変数の設定内容が一時的に保存されている。

**蟻人間** ◆T6xkBnTXz7B0 · 2021/06/13(日) 15:30:14.97

間違えずに書く自信のある人なら、CMakeCache.txtに書かれてる内容を直接書き換えてもいい。

**デフォルトの名無しさん** · 2021/06/14(月) 10:48:01.94

>>17
蟻は調べながら受け売りコピペしてるだけ
結局自分で調べた方が早い

**デフォルトの名無しさん** · 2021/06/14(月) 13:15:02.79

調べて載せてくれてるならいいじゃないのコピペだって
多少の間違いは周りが訂正してあげれば十分
そんな叩いてばかりしてたらコミュニティが過疎っしまいますよ

**デフォルトの名無しさん** · 2021/06/14(月) 16:44:53.08

そんなクソコミュニティ、元々いらんのだが。

**デフォルトの名無しさん** · 2021/06/14(月) 18:27:19.15

糞コミュニティなんていくらでもあるんだから、自分に必要ないと思ったら
寄っていかなきゃいいだけ。

**デフォルトの名無しさん** · 2021/06/14(月) 18:53:14.11

Part 1とか付けると2まで伸びないというジンクスがある。

**デフォルトの名無しさん** · 2021/06/15(火) 01:22:59.73

いつも思うことだがツールチェインとか特に
便利にしようと思って作ったのは気持ち的にはわからんでもないけど
かえって手間が増えてんだよねえ・・

移植作業が必要だのなんだのいっても普通にMakefileでいいわってなる
たいした手間じゃないしな
他の奴らも全てに精通してるわけじゃないし