前言:
最近在学习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或者最终的共享库,不包含编译生成
的中间文件)