JNI介绍(五)：

1.前言

NDK 构建代码有两种方法：ndk-build 和 CMake。在之前介绍 JNI 的文章都是采用 ndk-build 的方式，对于CMake 的方式一直没有尝试过。此篇文章将采用 CMake 和 Kotlin 的方式来进行 JNI 的调用。ndk-build 的方式可以参考之前的几篇文章：

JNI介绍(一)、JNI介绍(二)、JNI介绍(三)、JNI介绍(四)。

2.CMake 的使用

2.1 确保下载了 CMake

2.2 创建支持 native 的项目

选择默认：

创建后的项目结构如下：自动创建了 CMakeLists.txt 文件和native-lib 文件：

在 module 的 build.gradle 中，自动添加了：

    externalNativeBuild {
        cmake {
            path "src/main/cpp/CMakeLists.txt"
            version "3.10.2"
        }
    }

 且在默认的 Activity 中定义了 native 方法，并且加载：

    external fun stringFromJNI(): String

    companion object {
        // Used to load the 'native-lib' library on application startup.
        init {
            System.loadLibrary("native-lib")
        }
    }

这里不采用直接在 Activity 中定义的方式。

2.3 创建 JniTools 类 

创建 JniTools 类：

package cn.zzw.ndk.native

class JniTools {
    external fun stringFromJNI(): String

    companion object {
        // Used to load the 'native-lib' library on application startup.
        init {
            System.loadLibrary("native-lib")
        }
    }
}

在 Java 中 方法名是以 native 开头，而在 kotlin 中是 external。kotlin 中不再有 static 关键字了，采用的是 companion object。

2.4 cpp 文件的修改

这里不再重新命名，沿用默认创建的 native-lib.cpp，其修改如下：

#include <jni.h>
#include <string>

extern "C"
JNIEXPORT jstring JNICALL
Java_cn_zzw_ndk_native_JniTools_stringFromJNI(JNIEnv *env, jobject thiz) {
    std::string info = "我是zuowei.zhang, JNI";
    return env->NewStringUTF(info.c_str());
}

 2.5 CMakeLists.txt 文件

因为 cpp 文件名没有做修改，所以这里 CMakeLists.txt 也不用做修改：

cmake_minimum_required(VERSION 3.4.1)


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 )


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

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

cmake_minimum_required(VERSION 3.4.1)：

用于指定 cmake 的最小版本

add_library(native-lib SHARED native-lib.cpp )：

第一个参数是库的名称；

第二个参数：STATIC 用于生成静态库，SHARED 用于生成动态库或者共享库；

第三个参数：对应的 cpp文件。

find_library(  log-lib  log )：

查找到指定的预编译库，并将它的路径存储在变量中。默认的搜索路径为 cmake 包含的系统库。

target_link_libraries( native-lib  ${log-lib} )：

第一个参数为 add_library 中添加的库名称，

第二个参数为 find_library 指定的变量名。

更多关于 CMakeLists.txt 的语法，可以参考这篇文章：CMakeLists.txt 语法介绍与实例演练。

2.6 JNI 调用并显示

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        val tools = JniTools()
        sample_text.text = tools.stringFromJNI()
    }
}

运行产生的 so库位于：

3.总结

CMake 的方式和 ndk-build 的方式相比，省掉通过命令行去生成 .h 文件以及 application.mk 和 android.mk 的编写。但是多了 CMakeLists.txt 文件的编写，需要去熟悉相关的语法。在 Android studio 的开发中 CMake 会是一种主流。