美文网首页
CMake学习

CMake学习

作者: MrLuo | 来源:发表于2017-12-28 17:10 被阅读8次

    前言:
    最近在学习NDK时,一些学习资料的项目都是在eclipse上写的,这些项目都是基于NDK构建的,但是现在的AndroidStudio都是基于CMake来编译C源码的。一时之间,完整的项目导入到AndroidStudio竟然编译不通过,那就来先学习一下CMake的用法吧,老式的构建方法晚点再研究。请关注吧。


    以下内容为CMake Practice一书的总结内容:
    跟着书本上,我运行了一个cmake的一个项目 ,很简单,就是创建了一个CMakeLists.txt和一个main.c文件,在AndroidStudio构建C源码时,也需要一个CMakeLists的文件来引导编译。在这个例子中,CMakeLists.txt的代码如下:

    PROJECT(HELLO)
    SET(SRC_LIST main.c)
    MESSAGE(STATUS "This is BINARY dir " ${HELLO_BINARY_DIR})
    MESSAGE(STATUS "This is SOURCE dir " ${HELLO_SOURCE_DIR})
    ADD_EXECUTABLE(hello ${SRC_LIST})
    

    一、例子:
    1.PROJECT
    PROJECT(prjectname [CXX] [C] [java])
    

    这个指令隐式的定义了两个cmake变量:
    <projectname>_BINARY_DIR以及<projectname>_SOURCE_DIR,这里就是
    HELLO_BINARY_DIR和HELLO_SOURCE_DIR;

    同时cmake系统也帮助我们预定义了PROJECT_BINARY_DIR和PROJECT_SOURCE_DIR
    变量,他们的值分别跟HELLO_BINARY_DIR与HELLO_SOURCE_DIR一致。
    为了统一起见,建议以后直接使用PROJECT_BINARY_DIR,PROJECT_SOURCE_DIR,即
    使修改了工程名称,也不会影响这两个变量。如果使用了
    <projectname>_SOURCE_DIR,修改工程名称后,需要同时修改这些变量。

    2.SET
    SET(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])
    

    现阶段,你只需要了解SET指令可以用来显式的定义变量即可。
    比如我们用到的是SET(SRC_LIST main.c),如果有多个源文件,也可以定义成:
    SET(SRC_LIST main.c t1.c t2.c)。

    2.MESSAGE
    MESSAGE([SEND_ERROR | STATUS | FATAL_ERROR] "message to display" ...)
    

    这个指令用于向终端输出用户定义的信息,包含了三种类型:
    SEND_ERROR,产生错误,生成过程被跳过。
    SATUS,输出前缀为—的信息。
    FATAL_ERROR,立即终止所有cmake过程.

    3.ADD_EXECUTABLE
    ADD_EXECUTABLE(hello ${SRC_LIST})
    

    定义了这个工程会生成一个文件名为hello的可执行文件,相关的源文件是SRC_LIST中.
    在本例我们使用了${}来引用变量,这是cmake的变量应用方式,但是,有一些例外,比
    如在IF控制语句,变量是直接使用变量名引用,而不需要${}。如果使用了${}去应用变
    量,其实IF会去判断名为${}所代表的值的变量,那当然是不存在的了。


    二、基本语法规则:

    1,变量使用${}方式取值,但是在IF控制语句中是直接使用变量名
    2,指令(参数1 参数2...)
    参数使用括弧括起,参数之间使用空格或分号分开。
    以上面的ADD_EXECUTABLE指令为例,如果存在另外一个func.c源文件,就要写成:

    ADD_EXECUTABLE(hello main.c func.c) //或者
    ADD_EXECUTABLE(hello main.c;func.c)
    

    3,指令是大小写无关的,参数和变量是大小写相关的。但,推荐你全部使用大写指令。

    注:
    这里需要特别解释的是作为工程名的HELLO和生成的可执行文件hello是没有任何关系的。
    hello定义了可执行文件的文件名,你完全可以写成:
    ADD_EXECUTABLE(t1 main.c)
    编译后会生成一个t1可执行文件。

    ADD_SUBDIRECTORY指令

    ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
    

    不论是SUBDIRS还是ADD_SUBDIRECTORY指令(不论是否指定编译输出目录),我们都可
    以通过SET指令重新定义EXECUTABLE_OUTPUT_PATH和LIBRARY_OUTPUT_PATH变量
    来指定最终的目标二进制的位置(指最终生成的hello或者最终的共享库,不包含编译生成
    的中间文件)

    相关文章

      网友评论

          本文标题:CMake学习

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