Android JNI使用笔记——以CMake添加第三方so库并本地使用

       JNI(Java Native Interface)让Java语言可以与其他语言交互。由于Java语言本身的性能局限，使用JNI可以大大提高程序的性能，但是却破坏了Java的可移植性，也对Java的安全带来了一定的隐患。
       本文通过AndroidStudio CMake工具编写使用jni代码。

JNI的基础使用步骤

在Java中

public class JniTest {
	static {
	//test-lib在后面定义
	    System.loadLibrary("ijkplayer");
        System.loadLibrary("test-lib");
    }
    public native String jniString();
}

2.生成头文件

#1.首先通过javac命令行生成class文件,如:javac <java文件的路径>
#2.通过javah命令行生成.h文件，如：javah -classpath < path > -jni <类全称>

javah命令行用法

用法:
  javah [options] <classes>
其中, [options] 包括:
  -o <file>                输出文件 (只能使用 -d 或 -o 之一)
  -d <dir>                 输出目录
  -v  -verbose             启用详细输出
  -h  --help  -?           输出此消息
  -version                 输出版本信息
  -jni                     生成 JNI 样式的标头文件 (默认值)
  -force                   始终写入输出文件
  -classpath <path>        从中加载类的路径
  -cp <path>               从中加载类的路径
  -bootclasspath <path>    从中加载引导类的路径
<classes> 是使用其全限定名称指定的

生成后的.h文件如下：

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class cn_luozhanming_opengldemo_JniTest */

#ifndef _Included_cn_luozhanming_opengldemo_JniTest
#define _Included_cn_luozhanming_opengldemo_JniTest
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     cn_luozhanming_opengldemo_JniTest
 * Method:    jniString
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_cn_luozhanming_opengldemo_JniTest_jniString
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

3.将生成的.h头文件放入指定native代码目录，如目录图中app/src/main/jni/include中

4.编写.h的实现代码JniTest.c

#include "cn_luozhanming_opengldemo_JniTest.h"


JNIEXPORT jstring JNICALL Java_cn_luozhanming_opengldemo_JniTest_jniString(
        JNIEnv *env,
        jobject obj) {
    const char *sdf = "sdfsdf";
    return (*env)->NewStringUTF(env, sdf);
}

5.编写CMakeLists.txt文件

cmake_minimum_required(VERSION 3.4.2)

include_directories(src/main/jni/include)
include_directories(src/main/jni/ffmpeg/include)

set(CPATH "${CMAKE_SOURCE_DIR}/src/main/jni")
set(FFMPEG_LIB_DIR "${CMAKE_SOURCE_DIR}/src/main/jni/ffmpeg")
//libs用于存放第三方so库目录
set(LIB_DIR "${CMAKE_SOURCE_DIR}/src/main/libs")
//声明c代码所在目录，会匹配所有子目录文件
file(GLOB_RECURSE myCFile "${CPATH}/*")

add_library(test-lib
        SHARED
        ${myCFile})
#find_library定义的库名称调用时需要添加${}
find_library(log-lib
        log)
#add_library的库名称不需要调用时不需要添加${}
add_library(ffmpeg-lib
        SHARED
        IMPORTED)
set_target_properties(ffmpeg-lib
        PROPERTIES IMPORTED_LOCATION
        ${LIB_DIR}/${ANDROID_ABI}/libijkffmpeg.so)

target_link_libraries( # Specifies the target library.
        test-lib
        ffmpeg-lib
        GLESv2
        EGL
        android
        ${log-lib}
        )

注意：编写的native代码必须添加到CMakeLists.txt文件内，否则将不参与代码编译，会出现#include报错。

6.修改Module的build.gradle

android {
    compileSdkVersion 29
    buildToolsVersion "29.0.0"
    defaultConfig {
        applicationId "cn.luozhanming.opengldemo"
        minSdkVersion 19
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

        externalNativeBuild {
            cmake {
                cppFlags "-std=c++11"
            }
            ndk {
            //需要编译的处理器架构
                abiFilters "armeabi-v7a"
            }
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            jniDebuggable = true
        }
    }

    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }

    sourceSets {
     main { 
       jni.srcDirs = [] 
       //第三方库引入必须使用jniLibs中添加路径
       jniLibs.srcDirs =['src/main/libs']}
     }
}

修改完后进行构建

7.调用native代码

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        val test = JniTest()
        findViewById<TextView>(R.id.textView).setText(test.jniString())
    }
}