Linuxコマンド - CMakeのソースを表示

== 概要 ==
CMakeとは、多様なプラットフォームでソースコードをビルドするためのツールである。<br>
<br>
ここでは、CMake向けに構築されたソースコードをコマンドラインからビルドする方法について記載する。<br>
<br><br>

== CMakeコマンドの基本 ==
まず、ビルドするディレクトリを作成して、そのディレクトリに移動する。<br>
ディレクトリを作成する理由は、ソースコードツリーがビルド時の生成ファイルで汚染されるのを防ぐためである。<br>
 mkdir build
 cd build
<br>
以下のように、CMakeコマンドを実行する。<br>
引数には、ソースコードのルートディレクトリ(CMakeLists.txtファイルがあるディレクトリ)を指定する。<br>
 cmake <ソースコードがあるディレクトリ> 
<br>
Makefileが作成されるので、それを使用してビルドを行う。<br>
 make -j 8
 make install  # ただし、CMakeLists.txtファイルに設定が記述されていることが必要
<br><br>

== オプションの指定 ==
CMakeコマンドの実行時に、オプションを指定することが可能である。<br>
<br>
インストールディレクトリを指定するには、以下のオプションを付加する。<br>
 cmake -DCMAKE_INSTALL_PREFIX=<インストールディレクトリ> <ソースコードがあるディレクトリ>
 または
 cmake --install <インストールディレクトリ>
<br>
CコンパイラまたはC++コンパイラを変更するには、以下のオプションを付加する。<br>
 cmake -DCMAKE_C_COMPILER=<Cコンパイラのパス> -DCMAKE_CXX_COMPILER=<C++コンパイラのパス> <ソースコードがあるディレクトリ>
<br>
オプション設定を対話式に変更する場合は、<code>ccmake</code>コマンドを使用する。<br>
ccmakeの操作方法は、画面下部に表示されている通りである。<br>
矢印キーもしくは[J]キー、[K]キーでカーソルが上下に移動すると、中段に選択中の変数の説明が表示される。<br>
[Enter]キーでその項目を編集して、[C]キーでConfigureを実行、[G]キーでGenerateを実行して、ccmakeを終了する。<br>
 ccmake <ソースコードがあるディレクトリ>
<br>
オプション設定をGUIに変更する場合は、buildディレクトリを作成して、その中で以下のコマンドを実行する。<br>
 cmake-gui <ソースコードがあるディレクトリ>
<br><br>

== ビルドタイプの指定 ==
変数を通したプロジェクト設定の例として、デバッグ / リリース等のビルドタイプを指定する方法がある。<br>
この設定には、<code>CMAKE_BUILD_TYPE、CMAKE_CONFIGURATION_TYPES</code>という2つのキャッシュ変数が絡む。<br>
どちらを設定すべきかは、ジェネレータによって変わる。<br>
<br>
==== Makefile ====
ジェネレータがMakefileの場合、単一のビルドオプションしか保持できないので、Configure / Generate時にビルドタイプを指定する。<br>
ビルドタイプは、キャッシュ変数<code>CMAKE_BUILD_TYPE</code>に値を設定することで指定できる。<br>
 cmake -DCMAKE_INSTALL_PREFIX=<インストールディレクトリ> -DCMAKE_BUILD_TYPE=Release <ソースコードがあるディレクトリ> 
<br>
次に、生成されたMakefileを使用してビルドする。<br>
 cmake --build .
<br>
CMakeでは、標準でDebug、Release、MinSizeRel、RelWithDebInfoの4種類のビルドタイプが用意されている。<br>
それぞれどのようなビルドオプションが採用されるかはコンパイラによって違うので、別途調べること。<br>
<br>
==== IDE ====
ジェネレータがVisual StudioやXcodeといったIDEの場合、プロジェクトファイルに複数のビルドタイプを保持できるので、<br>
Configure / Generate時にビルドタイプを指定する必要はない。<br>
 cmake -DCMAKE_INSTALL_PREFIX=<インストールディレクトリ> <ソースコードがあるディレクトリ> 
<br>
次に、ビルドの実行時に、どのビルドタイプを使用するかを指定する。<br>
 cmake --build . --config Release
<br>
プロジェクトファイルに含めるビルドタイプを、<code>Release</code>と<code>RelWithDebInfo</code>の2つに限定する場合は、<br>
キャッシュ変数<code>CMAKE_CONFIGURATION_TYPES</code>に<code>Release;RelWithDebInfo</code>のように値を設定する。<br>
<br><br>

== CMakeのインストール ==
[https://cmake.org/download/ CMakeの公式Webサイト]にアクセスして、<br>
cmake-<バージョン>.tar.gzファイル(ソースコード)またはcmake-<バージョン>-linux-x86_64.tar.gzファイル(バイナリ)をダウンロードする。<br>
<br>
==== バイナリファイルをインストールする場合 ====
cmake-<バージョン>-linux-x86_64.tar.gzファイル(バイナリ)をを解凍して、任意のインストールディレクトリに配置する。<br>
 tar xf cmake-<バージョン>-linux-x86_64.tar.gz
 mv cmake-3.22.1-linux-x86_64 CMake
 cp -r CMake <CMakeのインストールディレクトリ>
<br>
CMake GUIもインストールする場合、デスクトップエントリファイルを作成する。<br>
 vi ~/.local/share/applications/CMake_GUI.desktop
<br>
 # ~/.local/share/applications/CMake_GUI.desktopファイル
 
 [Desktop Entry]
 Type=Application
 Version=1.0
 Name=CMake
 Comment=Cross-platform buildsystem
 Exec=/<CMakeのインストールディレクトリ>/bin/cmake-gui %f
 Icon=/<CMakeのインストールディレクトリ>/share/icons/hicolor/128x128/apps/CMakeSetup
 Categories=Development;
 MimeType=application/x-cmakecache;
 Terminal=false
 X-MultipleArgs=false
 StartupNotify=true
<br>
~/.profileファイル等に環境変数PATHを追記する。<br>
 vi ~/.profile
<br>
 # ~/.profileファイル
 
 export PATH="/<CMakeのインストールディレクトリ>/bin:$PATH"
<br>
==== ソースコードからインストールする場合 ====
cmake-<バージョン>.tar.gzファイル(ソースコード)を解凍する。<br>
 tar xf cmake-<バージョン>.tar.gz
 cd cmake-<バージョン>
<br>
ビルド用ディレクトリを作成する。<br>
 mkdir build && cd build
<br>
CMakeをビルドおよびインストールする。<br>
 # CMake GUIをインストールする場合
 ../configure --qt-gui --prefix=<CMakeのインストールディレクトリ>
 
 # CMake GUIをインストールしない場合
 ../configure --prefix=<CMakeのインストールディレクトリ>
 
 gmake -j $(nproc)
 gmake install
<br>
CMake GUIもインストールする場合、デスクトップエントリファイルを作成する。<br>
 vi ~/.local/share/applications/CMake_GUI.desktop
<br>
 # ~/.local/share/applications/CMake_GUI.desktopファイル
 
 [Desktop Entry]
 Type=Application
 Version=1.0
 Name=CMake
 Comment=Cross-platform buildsystem
 Exec=/<CMakeのインストールディレクトリ>/bin/cmake-gui %f
 Icon=/<CMakeのインストールディレクトリ>/share/icons/hicolor/128x128/apps/CMakeSetup
 Categories=Development;
 MimeType=application/x-cmakecache;
 Terminal=false
 X-MultipleArgs=false
 StartupNotify=true
<br>
~/.profileファイル等に環境変数PATHを追記する。<br>
 vi ~/.profile
<br>
 # ~/.profileファイル
 
 export PATH="/<CMakeのインストールディレクトリ>/bin:$PATH"
<br><br>

== Extra CMake Module(ECM)のインストール ==
[https://github.com/KDE/extra-cmake-modules/tags Extra CMake ModuleのGithub]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf extra-cmake-modules-<バージョン>.tar.gz
 cd extra-cmake-modules-<バージョン>
<br>
次に、Extra CMake Moduleのビルドに必要なライブラリをインストールする。<br>
 sudo zypper install sphinx libsphinxclient-devel reuse
<br>
ビルド用ディレクトリを作成して、Extra CMake Moduleをビルドおよびインストールする。<br>
<u>Extra CMake ModuleのインストールディレクトリはCMakeのインストールディレクトリを共通であることに注意する。</u><br>
 mkdir build && cd build
 
 cmake -DCMAKE_INSTALL_PREFIX=<CMakeのインストールディレクトリ> ..
 make -j $(nproc)
 make install
<br><br>

__FORCETOC__
[[カテゴリ:CentOS]][[カテゴリ:SUSE]]