1.cmake作用
cmake是开源的跨平台的生成native的编译配置文件的工具,使用cmake可以生成适应当前编译平台的makefile文件,无论在windows、linux还是mac平台上,构建c/c++项目(库或者可执行程序)都可以统一的cmake+make来实现。mac 上cmake分命令行和cmake gui两种方式,cmake在mac上需要安装并且需要配置到环境变量中,具体安装步骤
2.cmake基本命令
注:此处列出的是命令的最基本使用方法,详细可选参数参考官方文档
1.定义工程名称,并可指定工程支持的语言,支持的语言列表可选,默认是支持c和c++.
PROJECT(projectname [CXX][C] [Java])
2.向终端输出用户定义的信息,包含了三种类型:
SEND_ERROR,产生错误,生成过程被跳过。
SATUS,输出前缀为—的信息。
FATAL_ERROR,立即终止所有 cmake 过程。
MESSAGE([SEND_ERROR | STATUS | FATAL_ERROR] "message to display" ...)
3.定义了这个工程会生成一个文件名为 hello 的可执行文件,相关的源文件是变量 SRC_LIST 中 定义的源文件列表
ADD_EXECUTABLE(hello ${SRC_LIST})
3.指定输出目录
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)
其中 PROJECT_BINARY_DIR 变量是project命令的产物,如果是外部编译执行..cmake
命令说在的命令,即build目录。
4.install命令
install命令其实是将build的产物文件拷贝到其它地方,用以给电脑上其它用户使用,install命令有其默认的安装路径CMAKE_INSTALL_PREFIX
默认值是/usr/local,也可以明确指定安装到其它路径。install的命令需要在make完成后再执行make install
才会被执行。
5.其它命令
cmake语法关键词不区分大小写,但变量名区分大小写。
a.打印日志,参数一表示日志级别,致命的日志可以终止cmake继续执行。
MESSAGE(STATUS “HOME dir: $ENV{HOME}”)
b.变量赋值
SET(变量名 值)
c.INCLUDE 外部cmake脚本,用来载入 CMakeLists.txt 文件,也用于载入预定义的 cmake 模块。处理到 INCLUDE 语句是直接执行。
INCLUDE(module [OPTIONAL])
d.FIND_LIBRARY命令,查找某一个库,最常用的就是查找 log库,用于引入android logcat输出日志能力
find_library(log-lib log)
e.此外cmake还有文件操作命令FILE
、条件控制IF/ELSE/ENDIF
、WHILE
、FOREACH
等,详细介绍可以参考官网文档
3.cmake技巧点
1.外部构建
默认的cmake是内部构建,会在当前目录添加中间生成的文件,而通常cmakelists.cmake都在项目根目录下,这样会导致生成的中间文件和项目文件混合影响阅读。所谓外部构建典型的其实就是专门和cmake并列建立一个build文件,以该文件为起点执行cmake ..(注意是两个点)。那么生成的中间文件都会出现在build文件中,项目中生成的库也都会默认以build为目标位置。这样把cmake中间文件以及构建项目的产出文件和项目源码分离了,即外部构建,所有项目都应该用外部构建。
ADD_LIBRARY(hello STATIC ${LIBHELLO_SRC})
2.关于链接外部库
同一个根cmakelists.cmake下include的子cmake或者add_subdirectory添加的子目录下的.cmake文件,如果不明确特殊指定,输出的库文件默认路径是同一路径,可以直接用库名字link。link外部库可以用绝对路径也可以用相对路径。
4.cmake跨平台编译安卓库记录
1.cmake-gui 除需要指定ndk choolchains外还需要添加ANDROID_TOOLCHAIN 指定c++编译器项
add Entry->ANDROID_TOOLCHAIN gcc/clang,mac实测只有gcc可以。
此处记录cmake gui跨平台编译opencv源码
opencv本身提供了基础必要的功能,还有额外的可选moudles,可以则需自己编译到opencv库里
mac cmake gui指定choolchains后可以跨平台编译安卓版本的opencv源码,并且可以指定添加可选moudles
具体步骤是:
1.下载opencv-master和opencv_contrib-master源码解压
2.打开cmake gui,设置源文件夹为opencv-master,新建空白文件夹,作为输出文件夹
3.点击configuration,选择unix makefiles ,cross platform,选择ndk路径下的build-cmake-android.choolchains,点击ok
4.如果报缺少ndk或者sdk路径,点击添加item,按照提示,手动添加配置项
5.配置成功后,会出现可配置列表,在opencv_extra_moudles_path中指定感兴趣去的moudle文件夹
6.点击generate
7.打开终端,cd到输出目录,依次执行
cmake .
make -j8
2.android studio的c++提示功能只有在指定了native的mk文件或者cmake脚本路径的,并且在mk或者cmake中将该cpp文件添加进编译的source了的才有输入提示功能。
externalNativeBuild {
ndkBuild {
//相对于项目根目录
path file('src/main/jni/Android.mk')
}
}
或者:
externalNativeBuild {
cmake {
//相对于项目根目录
path 'CMakeLists.txt'
}
}
参考网站:
网友评论