美文网首页
cmake脚本基础

cmake脚本基础

作者: 太白新星 | 来源:发表于2019-06-04 10:35 被阅读0次

    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/ENDIFWHILEFOREACH等,详细介绍可以参考官网文档

    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实践及其示例项目

    相关文章

      网友评论

          本文标题:cmake脚本基础

          本文链接:https://www.haomeiwen.com/subject/okclxctx.html