CMake命令

1.aux_source_directory

#查找当前目录所有源文件，并将源文件名称列表保存到DIR_SRCS变量 （不能查找子目录）
aux_source_directory(. DIR_SRCS)

2.添加一个库或预编译库

#添加一个库，名为<name>。指定STATIC,SHARED,MODULE参数来指定库的类型。STATIC:静态库；SHARED:动态库，
#MODULE:在使用dyld的系统有效，若不支持dyld,等同于SHARED。EXCLUDE_FROM_ALL:表示该库不会被默认构建。
#source1 source2 ... srouceN:用来指定库的源文件
add_library(<name> [STATIC|SHARED|MODULE] [EXCLUDE_FROM_ALL] source1 source2 ... sourceN)

#添加一个已存在的预编译库，名为<name>。一般配合set_target_properties使用
add_library(<name> <SHARED|STATIC|MODULE|UNKNOW> IMPORTED)
例子：
add_library(test SHARED IMPORTED)
set_target_properties(
	test #指明目标库名
	PROPERTIES IMPROTED_LICATION #指明要设置的参数
	库路径/${ANDROID_ABI}/libtest.so # 导入库的路径
)

3.set命令

#设置可执行文件的输出路径(EXCUTABLE_OUTPUT_PATH是全局变量)
set(EXECUTABLE_OUTPUT_PATH [output_path])

#设置库文件的输出路径(LIBRARY_OUTPUT_PATH是全局变量)
set(LIBRARY_OUTPUT_PATH [output_path])

#设置C++编译参数(CMAKE_CXX_FLAGS是全局变量)  相当于设置环境变量
set(CMAKE_CXX_FLAGS "-Wall std=c++11")

#设置源文件集合(SOURCE_FILES是本地变量即自定义变量)
set(SOURCE_FILES main.cpp test.cpp ...)

4.设置头文件目录

#可以用相对路径或绝对路径 也可以用自定义的变量值
include_directories(./include ${MY_INDLUDE})
相当于g++选项中的-I参数

5.添加可执行文件

add_executable(<name> ${SRC_LIST})
name是文件名  SRC_LIST 文件列表

6.将若干库链接到目标库文件

target_link_libraries(<name> lib1 lib2 lib3)
name为目标库的名字

#如果出现互相依赖的静态库，CMake会允许依赖图中包含循环依赖 如：
add_library(A STATIC a.c)
add_library(B STATIC b.c)
target_link_libraries(A B)
target_link_libraries(B A)
add_executable(main main.c)
target_link_libraries(main A)

#链接的顺序应当符合gcc链接顺序规则，被链接的库放在依赖它的库后面，即如果上面的命令中，lib1依赖于lib2,
lib2又依赖于lib3,则在上面命令中必须严格按照lib1lib2lib3的顺序排列，否则会报错

7.添加编译参数 add_definitions

#为当前路径以及子目录的源文件加入-D引入的define flag
add_definitions(-DF00 -DDEBUG ...)

8.指定子目录的CMake源文件

#sub_dir指定包含CMakelists.txt和源文件的子目录位置
#binary_dir是输出路径，一般可以不指定
add_subdirectory(sub_dir [binary_dir])

如果当前目录下还有子目录时可以使用add_subdirectory,子目录中也需要包含有CMakelists.txt

9.file命令

10.设置某个路径的一种属性

set_directory_properties(PROPERTIES prop1 value1 prop2 value2)
#设置某个路径的一种属性
#prop1, prop2代表属性，取值为：INCLUDE_DIRECTORIES LINK_DIRECTORIES INCLUDE_REGULAR_EXPRESSION ADDITIONAL_MAKE_CLEAN_FILES

11.在给定的作用域内设置一个命名的属性

set_property(<GLOBAL | DIRECTORY [dir] | TARGET [target ...] | SOURCE [src1 ... ] | TEST [test1 ... ] | 
	CACHE [entry1 ...]> [APPEND] PROPERTY <name> [value ..])
#PROPERTY参数是必须的
#第一个参数决定了属性可以影响的作用域：
	GLOBAL:全局作用域
	DIRECTORY:默认当前路径，也可以用[dir]指定路径
	TARGET:目标作用域，可以是0个或多个已有目标
	SOURCE：源文件作用域，可以是0个或多个源文件
	TEST: 测试作用域，可以是0个或多个已有的测试
	CACHE:必须指定0个或多个cache中已有的条目

案例1：多个源文件处理

如果源文件很多，把所有文件一个个加入很麻烦，可以使用aux_source_directory命令或者file命令，会查找指定目录
下的所有源文件，然后将结果存进指定变变量名

#查找当前目录所有源文件，并将名称保存到DIR_SRCS变量 不能查找子目录
aux_source_directory(. DIR_SRCS)
#也可以使用
file(GLOB DIR_SRCS *.c *.cpp)

add_library(native-lib SHARED ${DIR_SRCS})

案例2：多目录多源文件处理

主目录中的CMakelists.txt中添加add_subdirectory(child)命令，指明本项目包含一个子项目child。并在
target_link_libraries指明本项目需要链接一个名为child的库
子目录child中创建CMakelists.txt,这里child编译为共享库
aux_source_directory(. DIR_SRCS)
add_subdirectory(child)
add_library(native-lib SHARED ${DIR_SRCS})
target_link_libraries(native-lib child)

#child目录下的CMakeLists.txt
aux_source_directory(. DIR_LIB_SRCS)
add_library(child SHARED ${DIR_LIB_SRCS})

案例3：添加预编译库
Android6.0之前

假设本地项目引入了libimported-lib.so
# 使用IMPROTED标志告知CMake只希望将库导入到项目中，如果是静态库则将SHARED改为STATIC
add_library(imported-lib SHARED IMPROTED)
set_target_properties(improted-lib PROPERTIES IMPORTED_LOCATION <路径>/libimported-lib.so)
aux_source_directory(. DIR_SRCS)
add_library(native-lib SHARED ${DIR_SRCS})
target_link_libraries(native-lib imported-lib)

Android6.0 之后

# set命令定义一个变量
# CMAKE_C_FLAGS:c的参数，会传递给编译器
# 如果是c++文件，需要用CMAKE_CXX_FLAGS
# -L 库的查找路径
相当于设置环境变量
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -L[SO所在目录]")

案例4：添加头文件目录

为了确保CMake可以在编译时定位头文件，使用include_directories,相当于g++选项中的-I参数。
这样就可以使用#include<xx.h>，否则需要使用#include “path/xx.h”

案例5：build.gradle配置