Android NDK编程(二)---CMakeList.txt详解

2019-07-25 14:40:23 浏览数 (1)

前言

前一篇我们介绍了《Android NDK编程(一)---NDK介绍及环境搭建》,简单介绍了一下什么是NDK和JNI,以前NDK环境的配置及怎么创建第一个NDK的程序,在上一篇的左侧栏中有一个CMakeList.txt的文件,这一章我们就来解析一下CMakeList文件。

CMake简介

CMake是一个跨平台的构建工具,可以用简单的语句来描述所有平台的安装(编译过程)。能够输出各种各样的makefile或者project文件。Cmake 并不直接建构出最终的软件,而是产生其他工具的脚本(如Makefile ),然后再依这个工具的构建方式使用。

CMake是一个比make更高级的编译配置工具,它可以根据不同平台、不同的编译器,生成相应的Makefile或者vcproj项目。从而达到跨平台的目的。Android Studio利用 CMake生成的是ninja,ninja是一个小型的关注速度的构建系统。我们不需要关心ninja的脚本,知道怎么配置cmake就可以了。从而可以看出cmake其实是一个跨平台的支持产出各种不同的构建脚本的一个工具。

CMake的脚本名默认是CMakeLists.txt。

CmakeList.txt

代码语言:javascript复制
#cmake的最低版本
cmake_minimum_required(VERSION 3.6)

# ${ANDROID_ABI} 构建的COU
# ${CMAKE_SOURCE_DIR} cmakeList.txt所在的文件夹路径
# message("","") 相当于log
# add_subdirectory(路径)  引入路径下的 cmakeList
# 源文件 最终生成的 so
add_library(变量名A SHARED B.c)
add_library(变量名A STATIC B.c)

# 源文件 最终生成的 so   多文件设置
file(GLOB 变量名SRCC  src/main/cpp/*.c  src/main/cpp/*.cpp)
add_library(变量名A SHARED ${SRCC})

# =========================添加依赖库1=================================
# 设置静态库以导入的形式加入到项目中来
add_library(变量名B STATIC IMPORTED)
set_target_properties(变量名B PROPERTIES IMPORTED_LOCATION 路径1/xx.a  路径2/xxx.so)

# ========================= 添加依赖库2 =================================

#设置动态依赖库1
# 添加动态库,为了android版本之间的兼容性,需要设置一个变量
# CMAKE_CXX_FLAGS c  的参数 会传给编译器
# CMAKE_C_FLAGS c的参数 会传给编译器
# 重新定义 CMAKE_CXX_FLAGS 变量的内容   (如果是c文件,需要用 CMAKE_C_FLAGS )
# CMAKE_SOURCE_DIR 当前文件的地址
# ANDROID_ABI 当前手机的ABI
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}  -L${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI}")

#设置动态依赖库2   会从 ndk中的platforms/android-21/arch-arm/usr/lib/  中查找log库 并赋值给log_lib
find_library( log-lib log )

# 为了确保 CMake 可以在编译时定位头文件 
# 这样就可以使用 #include <xx.h> 引入 
# 否则需要使用 #include "path/xx"
 include_directories( imported-lib/include/ )

# 设置依赖的库
# 如果是静态库,需要根据 add_library中设置的变量名B去查找
# 如果是动态库,需要根据  CMAKE_CXX_FLAGS 改变后的路径下去按照库名查找
target_link_libraries( 要生成的库A  依赖的库B  ${log-lib} )

我们默认生成的CMakeList.txt为下面代码

代码语言:javascript复制
# 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)

# Creates and names a library, sets it as either STATIC
# or SHARED, and provides the relative paths to its source code.
# You can define multiple libraries, and CMake builds them for you.
# Gradle automatically packages shared libraries with your APK.

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).
        native-lib.cpp)

# Searches for a specified prebuilt library and stores the path as a
# variable. Because CMake includes system libraries in the search path by
# default, you only need to specify the name of the public NDK library
# you want to add. CMake verifies that the library exists before
# completing its build.

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)

# Specifies libraries CMake should link to your target library. You
# can link multiple libraries, such as libraries you define in this
# build script, prebuilt third-party libraries, or system libraries.

target_link_libraries( # Specifies the target library.
        native-lib

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

build.gradle

回到我们创建的那个vaccaendk的项目中,我们点击build.gradle的文件,特别关注一下android.defaultConfig.externalNativeBuild和externalNativeBuild这两个

android.defaultConfig.externalNativeBuild

代码语言:javascript复制
externalNativeBuild { 
  cmake {arguments "-DANDROID_TOOLCHAIN=clang", //使用的编译器clang/gcc
                    "-DANDROID_STL=gnustl_static"//cmake默认就是 gnustl_static
              cFlags ""     //这里也可以指定cflag和cxxflag,效果和之前的cmakelist里使用一样
              cppFlags ""
             //指定需要编译的cpu架构
              abiFilters "armeabi-v7a"
             //指定需要编译的模块(如Cmake中配置了生成native-lib、native-lib2)
             //默认按照cmake的配置编译所有
             //这里指定只编译 native-lib 模块
            targets "native-lib"
  }

}

externalNativeBuild

代码语言:javascript复制
externalNativeBuild {
            cmake {
              //指定脚本路径 当前build.gradle文件的相对路径
              path "xxx/CMakeLists.txt"
            }
}

-END-

0 人点赞