Jni基础开发入门（五）

摘要

对于NDK开发，很重要就是对第三方依赖的支持，那么在Android Studio2.2中，我们如何实现这个过程呢，当然还是先Cmake脚本上下一些功夫。

---

Cmake配置

在最新版的Android Studio中已经将NDK librarys添加到CMakelists.txt脚本文件中。Google已经将其简化到，我们只需要向CMake提供我们使用的libary名字就可以。

• find_library（）m命令
  这个命令可以定位NDK library的位置，并将其存储到一个变量之中。我们可以从官方的案例中可以看到，已经将ANdroid-specific log support library 的位置存储到变量log-lib中：

 find_library( # Defines the name of the path variable that stores the
              # location of the NDK library.
              log-lib

              # Specifies the name of the NDK library that
              # CMake needs to locate.
              log )

同样，NDK也允许你加载一些只含有源码的library，当然这个需要自己进行编译后，连接到你的本地库中。Ndk提供我们一个add_library()命令将源码编译进本地库中。我们只需要提供我们本地NDK的安装路径，通常这个路径已经保存在ANDROID_NDK变量中。这样AS就会自动的识别。

下面的命令告诉 CMake 去构建 android_native_app_glue.c ，这个命令可以管理 NativeActivity 的生命周期以及点击输入，并将其导入静态库中，然后将其链接至 native-lib ：

add_library( app-glue
             STATIC
             ${ANDROID_NDK}/sources/android/native_app_glue/android_native_app_glue.c )

# You need to link static libraries against your shared native library.
target_link_libraries( native-lib app-glue ${log-lib} )

同时这里需要解释几个声明
STATIC：静态库，是目标文件的归档文件，在链接其它目标的时候使用。
SHARED：动态库，会被动态链接，在运行时被加载。
MODULE：模块库，是不会被链接到其它目标中的插件，但是可能会在运行时使用dlopen-系列的函数动态链接。

然后你需要使用 set_target_properties() 命令去指定库的路径，就像下面的代码那样。

一些库会根据不同的 CPU 使用不同的包，或者是 Application Binary Interfaces(ABI) ，并且将他们归类到不同的目录中。这样做的好处是，可以充分发挥特定的 CPU 架构。你可以使用 ANDROID_ABI 路径变量，将多个 ABI 版本的库添加到你的 CMake 构建脚本中。这个变量使用了一些 NDK 默认支持的 ABI，以及一些需要手动配置到 Gradle 的 ABI，比如：

add_library(...)
set_target_properties( 
   # Specifies the target library.
   imported-lib

   # Specifies the parameter you want to define.
   PROPERTIES IMPORTED_LOCATION

   # Provides the path to the library you want to import.
   imported-lib/src/${ANDROID_ABI}/libimported-lib.so )

为了让 CMake 在编译时期能找到你的头文件，你需要使用 include_directories() 命令，并且将你的头文件地址传进去：

include_directories( imported-lib/include/ )
在 CMake 构建脚本中使用 target_link_libraries() 命令，将预构建库与你本地库相关联：

target_link_libraries( native-lib imported-lib app-glue ${log-lib} )
当你构建你的 APP 的时候，Gradle 会自动将导入的库打包到你的 APK 中。你可以使用 APK Analyzer 来检查。

---

• 拓展之使用第三方so库
  在一些情况下，我们没有能力开发so库，当别人抛一个库过来的时候我们直接使用就好了。

首先，我们告诉脚本我们只需要导入so库，不需要构建操作。

add_library( imported-lib
             SHARED
             IMPORTED )

IMPORTED:
表示只需要导入，不需要构建so库。
接着，我们要设置so库的路径了

set_target_properties(target1 target2 ...
                      PROPERTIES prop1 value1
                      prop2 value2 ...)

举例：

set_target_properties(
                      imported-lib // so库的名称
                      PROPERTIES IMPORTED_LOCATION // import so库
                      libs/libimported-lib.so // so库路径
)

当使用已经存在so库时，不应该配置target_link_libraries()方法，因为只有在build 库文件时才能进行link操作。

---

• 设置路径并引用
  如果我们使用了第三方的sdk,那么我们需要设置他们的路径，来让我们的cmake进行配置

#工程路径
set(pathToProject D:/Android/HelloCv)
#OpenCV-android-sdk路径
set(pathToOpenCv C:/Developer/OpenCV-android-sdk)

展示一个比较全的配置Cmakelists.txt

# Sets the minimum version of CMake required to build the native
# library. You should either keep the default value or only pass a
# value of 3.4.0 or lower.

#工程路径
set(pathToProject D:/AndroidSpace/20160923/HelloCv-master)
#OpenCV-android-sdk路径
set(pathToOpenCv C:/Developer/OpenCV-android-sdk)

#CMake版本信息
cmake_minimum_required(VERSION 3.4.1)
#支持-std=gnu++11
set(CMAKE_VERBOSE_MAKEFILE on)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=gnu++11")

#配置加载native依赖
include_directories(${pathToOpenCv}/sdk/native/jni/include)

#CPP文件夹下带编译的cpp文件
add_library( native-lib SHARED src/main/cpp/native-lib.cpp )

#动态方式加载
add_library( lib_opencv SHARED IMPORTED )

#引入libopencv_java3.so文件
set_target_properties(lib_opencv PROPERTIES IMPORTED_LOCATION ${pathToProject}/app/src/main/jniLibs/${ANDROID_ABI}/libopencv_java3.so)

#C++日志
find_library( log-lib log )

#target_link_libraries( native-lib $\{log-lib} )
target_link_libraries( native-lib $\{log-lib} lib_opencv)

我们需要在build.grade中加入以下架构，可以在build中的jni找到对应的so

externalNativeBuild {
    cmake {
        cppFlags "-std=c++11 -frtti -fexceptions"
        abiFilters 'x86', 'x86_64', 'armeabi', 'armeabi-v7a', 'arm64-v8a', 'mips', 'mips64'
    }
}