1 语法特性介绍

• 基本语法格式——指令（参数1 参数2）
• • 参数使用括弧括起来；
• • 参数之间使用空格或者分号隔开；

set(HELLO hello.cpp)
add_executable(hello main.cpp hello.cpp)
ADD_EXECUTABLE(hello main.cpp ${HELLO})

• 变量使用${}方式取值，但是在IF控制语句中是直接使用变量名

2 重要指令和CMake常用变量

2.1 重要指令

• cmake_minimum_required——指定CMake的最小版本要求
• • 语法：cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])

# CMake最小版本要求为2.8.3
cmake_minimum_required(VERSION 2.8.3)

• project——定义工程名称，并可指定工程支持的语言
• • 语法：project(project name[CXX] [C] [Java])

# 指定工程名为HELLOWORLD
project(HELLOWORLD)

• set——显示的定义变量
• • 语法：set(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])

# 定义SRC变量，其值为main.cpp和hello.cpp
set(SRC main.cpp hello.cpp)

• include_directories——向工程添加多个特定的头文件搜索路径----->相当于指定g++编译器参数-I
• • 语法：include_directories([AFTER|BEFORE][SYSTEM]dir1 dir2...)

# 将/usr/include/myinclude和./include添加到头文件搜索路径
include_directories(/usr/include/myinclude ./include)

• add_library——生成库文件
• • 语法：add_library(libname[SHARED|STATIC|MODULE][EXCLUDE_FROM_ALL] source1 source2 ... sourceN)

# 通过变量SRC生成libhello.so共享库
add_library(hello SHARED ${SRC})

• add_compile_options——添加编译参数
• • 语法：add_compile_options(...)

# 添加编译参数 -wall -std=c++1 -o2
add_compile_options(-wall -std=c++1 -o2)

• add_executable——生成可执行文件
• • 语法：add_executable(exename source1 source2 ... sourceN)

# 编译main.cpp为可执行程序main
add_executable(main main.cpp)

• target_link_libraries——为target添加需要链接的共享库文件------>相当于指定g++编译器的-l参数
• • 语法：target_link_libraries(target library1<debug | optimized> library2...)

# 将hello动态库文件链接到可执行文件main
target_link_libraries(main hello)

• add_subdirectory——向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置
• • 语法：add_subdirectory(source_dir [binary_dir][EXCLUDE_FROM_ALL])

# 添加src子目录，src中必须具备一个CMakelists.txt即使它为空文件
add_subdirectory(src)

• aux_source_directory——发现一个目录下所有的源代码文件并将列表存储在一个变量中，这个指令临时被用来自动构建源文件列表
• • 语法：aux_source_directory(dir VARIABLE)

# 定义SRC变量，其值为当前目录下所有的源代码文件
aux_source_directory(. SRC)
# 编译SRC变量所代表的源代码文件，生成main可执行文件
add_executable(main ${SRC})