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())
    }
}