cmake脚本基础

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'
        }
    }

参考网站:

cmake官方文档

cmake实践及其示例项目

1.cmake作用

2.cmake基本命令

3.cmake技巧点

4.cmake跨平台编译安卓库记录

猜你喜欢