message()コマンドの先頭にFATAL_ERRORを付ける。
message(FATAL_ERROR "hogehoge error message")
CMakeファイル内で、変数が定義されているかを調べるには、以下のようにする：
if (VARIABLE) ... endif ()
if (${VARIABLE})ではない。
このような定義判定は、cmakeコマンドを呼び出す際の変数定義のために使用する：
cmake .. -DVARIABLE=1
source_group()命令を使う。
source_group(フィルタ名 FILES ファイルリスト) source_group(フィルタ名 REGULAR_EXPRESSION 正規表現で書かれたファイルリスト)
サブディレクトリをフィルタ名に設定する場合は、ディレクトリ区切り文字を「\\」(バックスラッシュ x 2)にする必要がある。「/」(スラッシュ)ではダメ。
| CMake | Visual C++ |
|---|---|
| project | ソリューション(.sln) |
| executable | 実行ファイルプロジェクト(.vcxproj) |
| library | スタティックライブラリプロジェクト(.vcxproj) |
project内には、複数のexecutable／libraryを追加できる。Visual Studioでこのcmakeを実行すると、複数のプロジェクトが入ったソリューションが生成される。
ビルド順を制御するには、add_dependencies()命令を使う。以下のようにすると、exe_nameをビルドするには、lib1_nameとlib2_nameが必要(に依存している)という意味になり、exe_nameをビルドする前にライブラリがビルドされる。
project(my_project CXX) add_executable(exe_name main.cpp) add_library(lib1_name STATIC lib1.cpp) add_library(lib2_name STATIC lib2.cpp) # 依存関係の定義 add_dependencies(exe_name lib1_name lib2_name) # リンク target_link_libraries(exe_name lib1_name lib2_name)
CMakeで出力ディレクトリを指定するには、以下の変数にディレクトリを指定する必要がある。
実行ファイルの場合：
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ../../../libs)
スタティックライブラリの場合(2つ両方)：
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ../../../libs) set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ../../../libs)
include(../path/myproject.cmake)
のようにinclude命令を使うと、他の.cmakeファイルに書かれた内容を読み込んで実行できる。
用例：
Visual C++環境向けに実行ファイルをビルドする場合、
add_executable(exe_name ${sources})
とするとコマンドライン(コンソール)プロジェクトになり、
add_executable(exe_name WIN32 ${sources})
とするとWin32のプロジェクトになる。main()の代わりにWinMain()が呼ばれる。OpenGLプロジェクトはこちら。
XcodeでiOS向けのビルドする場合は、以下のようにMACOSX_BUNDLEを付ける。
add_executable(exe_name MACOSX_BUNDLE ${sources})
なお、この設定は変数化できる。
if (WIN32)
set(exe_mode WIN32)
else ()
set(exe_mode "")
endif ()
add_executable(exe_name ${exe_mode} ${sources})
