CMakeList语法知识

在写这篇文章之前开始是想一些shell脚本与Makefile的一些基础语法知识。但是又觉得太过基础。关于Liunx shell脚本可以看看教程http://c.biancheng.net/linux_tutorial/ CMake是一种跨平台编译工具，CMake主要是编写CMakeLists.txt文件，然后通过cmake命令将CMakeLists.txt文件转化为make所需要的Makefile文件，最后用make命令编译源码生成可执行程序或者库文件。实际项目中的C/C++文件不计其数、文件放置的位置也不同，Makefile定义了一系列的规则来指定，哪些文件需要先编译，哪些文件需要后编译，哪些文件需要重新编译，甚至于进行更复杂的功能操作。实现自动化的编译。

CMake方式编译生成库文件

以简单的例子来来看看CMake的语法,创建一个 test项目，项目结构如下
├── test目录
│ ├── CMakeLists.txt
│ ├── include目录
│ │ ├── myprint.h
│ ├── src 目录
│ │ ├── myprint.cpp
│ ├── lib目录
│ ├── biuld目录

示例项目目录结构.png

include目录放置头文件，src目录下放置的是.c/.cpp源文件，biuld目录是用来构建的项目，lib目录用来放置我们生成库文件。
include目录下的myprint.h头文件

#include
#include

void myprint(char* str);

src目录下myprint.cpp文件

#include "/usr/demo/test5/include/myprint.h"

void myprint(char* str) {

        printf("%s",str);

}

怎样利用CMake来将项目编译成动态库提供给其他项目使用。首先我们要创建CMakeLists.txt文件，简单的来说CMake就是我们把编译信息录入，cmake命令根据CMakeLists.txt生成编译需要的Makefile文件。看看CMakeLists.txt具体的编写

#指定CMake编译最低要求版本
CMAKE_MINIMUM_REQUIRED(VERSION 3.14)
#给项目命名
PROJECT(MYPRINT)
#收集c/c++文件并赋值给变量SRC_LIST_CPP  ${PROJECT_SOURCE_DIR}代表区当前项目录
FILE(GLOB SRC_LIST_CPP ${PROJECT_SOURCE_DIR}/src/*.cpp)
FILE(GLOB SRC_LIST_C ${PROJECT_SOURCE_DIR}/src/*.c)
#指定头文件目录
INCLUDE_DIRECTORIES(${PROJECT_SOURCE_DIR}/include)
#指定生成库文件的目录
SET(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
#去变量SRC_LIST_CPP 与SRC_LIST_C 指定生成libmyprint 动态库   默认生成静态库  SHARED指定生成库类型为动态库
ADD_LIBRARY(myprint SHARED ${SRC_LIST_CPP} ${SRC_LIST_C})

编写好CMakeLists.txt文件 cd到项目biuld目录执行cmake命令 将会在biuld目录下生成Makefile文件，执行make命令项目就会开始编译，在项目lib目录下生成libmyprint.so文件，是不是非常简单，相比编写Makefile文件来说。生成的动态库文件那么我们怎么去链接使用他呢？继续往下看

CMake链接使用库文件

这里就不新建项目啦，直接在src目录下新建源文件建hello.cpp 来应用libmyprint.so库。

#include 
#include "/usr/demo/test5/include/myprint.h"

int main() {
        myprint("hello World\n");
        return 0;
}

那么我们就要重新写个CMakeLists.txt文件，内容如下

CMAKE_MINIMUM_REQUIRED(VERSION 3.14)
#指定项目名称
PROJECT(HELLO)

#将hello.cpp 赋值给SOURCE 变量
SET(SOURCE ${PROJECT_SOURCE_DIR}/src/hello.cpp)

#指定头文件目录
INCLUDE_DIRECTORIES(${PROJECT_SOURCE_DIR}/include)
#指定链接库文件目录
LINK_DIRECTORIES(${PROJECT_SOURCE_DIR}/lib)

#将hello.cpp生成可执行文件hello 
ADD_EXECUTABLE(hello ${SOURCE})

#指定hello 链接库myprint
TARGET_LINK_LIBRARIES(hello myprint)

cd到项目biuld目录执行cmake命令 将会在biuld目录下生成Makefile文件，执行make命令，编译完后，将在biuld目录下生成可执行文件hello。执行hello

helloworld.png

Android程序员学习CMake最终还是要为我们Android项目服务，Android studio 2.2 之后开始采用 CMake 的这种方式来构建NDK项目。包括一些优秀的开源库也有采用CMake的方式来编译。具体看看CMake在Android中的使用。

Android中的CMakeLists.txt

由于后面会写一些关于NDK音视频的知识,就以引入FFmpeg音视频库来看看Android 中CMakeLists.txt是怎么编写的。

# For more information about using CMake with Android Studio, read the
# documentation: https://d.android.com/studio/projects/add-native-code.html

# Sets the minimum version of CMake required to build the native library.
cmake_minimum_required(VERSION 3.4.1)
# 需要引入我们头文件,以这个配置的目录为基准
include_directories(${CMAKE_SOURCE_DIR}/src/main/cpp/include)
#添加共享库搜索路径
link_directories(${CMAKE_SOURCE_DIR}/src/main/jniLibs/armeabi)
# 指定源文件目录
AUX_SOURCE_DIRECTORY(${CMAKE_SOURCE_DIR}/src/main/cpp SRC_LIST)

add_library(
        # Sets the name of the library.
        native-lib
        # Sets the library as a shared library.
        SHARED
        # Provides a relative path to your source file(s).
#        src/main/cpp/native-lib.cpp
        ${SRC_LIST}
        )

find_library( # Sets the name of the path variable.
        log-lib
        # Specifies the name of the NDK library that
        # you want CMake to locate.
        log )

target_link_libraries( # Specifies the target library.

        native-lib
        avcodec-57
        avdevice-57
        avfilter-6
        avformat-57
        avutil-55
        swresample-2
        swscale-4
        postproc-54

        # Links the target library to the log library
        # included in the NDK.
        ${log-lib} )

总结

了解了CMake语法，以及它正真的意义。以后遇上Android NDK项目便可以自己编写CMakeLists.txt文件内容。要想更深的深入可以去学习一下CMake文档。