美文网首页CMakeList
CMakeList语法知识

CMakeList语法知识

作者: 小小混世魔王 | 来源:发表于2019-06-13 13:39 被阅读0次

    在写这篇文章之前开始是想一些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<stdio.h>
    #include<stdlib.h>
    
    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 <stdio.h>
    #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文档。

    相关文章

      网友评论

        本文标题:CMakeList语法知识

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