Android：JNI与NDK(一)

最新推荐文章于 2022-03-29 21:45:00 发布

汪磊的博客

最新推荐文章于 2022-03-29 21:45:00 发布

阅读量175

点赞数

分类专栏： JNI/NDK

本文链接：https://blog.csdn.net/qq_16386581/article/details/88972376

版权

JNI/NDK 专栏收录该内容

5 篇文章 1 订阅

订阅专栏

本篇目录

以下举例代码均来自：NDK示例代码

一、前言

安卓开发中很多场景需要用到NDK来开发，比如，音视频的渲染，图像的底层绘制，秘籍计算应用，复用C/C++库等等，安卓绝大部分核心代码都是在Native层来完成，也就是用C/C++来完成，有的时候我们看系统源码的时候追着追着就发现最终调用一个native声明的方法，接下来就需要深入native层来查看具体逻辑了，那java代码是怎么调用native层代码的呢？或者说java是怎么调用C/C++代码的呢？这里就用到JNI/NDK方面技术了，本系列不会细讲C/C++语言知识，语言方面需要你自己私下学习，如果你想深入NDK层学习，那么请务必先学习一下C/C++语言知识，起码能看得懂啊，学习的时候可以尝试用C/C++来刷LeetCode，防止不用慢慢就忘记了，好了，接下来我们进入本篇正题。

二、什么是JNI/NDK

JNI

JNI是java的特性，与安卓无关，用来增强java与本地代码交互的能力，JNI是Java的一个框架，定义了一系列方法可以用于Java与C/C++互相调用。

NDK

NDK是安卓平台的开发工具包，是安卓的特性，与java无关，用来快速开发生成C、 C++的动态库，通过 NDK我们可以在 Android中将C/C++代码编译到原生库中，然后使用 IDE 集成构建系统 Gradle 将您的库封装入 APK。

JNI是Java特性，在window平台可以用java的JNI特性来完成java与C/C++互相调用，linux平台也可以，NDK是安卓平台的开发工具包，在安卓开发的时候我们可以通过Java的JNI特性来完成java与C/C++互相调用，但是C/C++代码怎么编译到原生库中呢？这时就用安卓平台提供的NDK开发工具了。

接下来我们就来看一下具体实现Java与C/C++互调。

三、Java与C/C++互调

AS配置NDK环境在3.0以上已经十分简单了，环境的配置请自行查阅搭建，这里我们直接讲解Java与C/C++互调知识。

JNI数据类型

JNI数据类型与Java数据类型对应如下：

Java类型	本地类型
boolean	jboolean
byte	jbyte
char	jchar
short	jshort
int	jint
long	jlong
float	jfloat
double	jdouble
Object	jobject
Class	jclass
String	jstring
Object[]	jobjectArray
boolean[]	jbooleanArray
byte[]	jbyteArray
char[]	jcharArray
short[]	jshortArray
int[]	jintArray
long[]	jlongArray
float[]	jfloatArray
double[]	jdoubleArray

这些对应关系什么意思呢？接下来通过具体实例了解一下：

创建新项目，我们在MainActivity中声明如下native方法：

native int arrayTest(int i,int[] a1, String[] a2);

意思是这个方法需要native层来实现，java调用的时候会传递三个参数，分别是：int ,int[] , String[] 类型的，接下来我们需要在native层来实现这个方法，AS中通过快捷键"alt+/"会自动帮助我们在native层来实现方法的声明：

JNIEXPORT jint JNICALL Java_com_wanglei55_ndk_MainActivity_arrayTest(JNIEnv *env,
        jobject instance,jint i,jintArray a1_,jobjectArray a2)

方法声明生成规则为：Java_包名_类名_方法名
java中声明的arrayTest方法参数类型分别为int，int[]，String[]类型，在JNI中生成的方法声明分别对应jint ，jintArray ，jobjectArray ，这里就用到了上面的数据类型对应表，至于其余参数类型依照上表对应即可。

我们观察JNI中方法声明还发现生成的方法对了一些额外信息：JNIEXPORT ，JNICALL ，参数中多了JNIEnv *env， jobject instance这些又都是什么鬼？我们一一解释

JNIEXPORT

在 Windows 中,定义为__declspec(dllexport)。因为Windows编译 dll 动态库规定，如果动态库中的函数要被外部调用，需要在函数声明中添加此标识，表示将该函数导出在外部可以调用。

在 Linux/Unix/Mac os/Android 这种类Unix系统中，定义为__attribute__ ((visibility ("default")))

GCC 有个visibility属性, 该属性是说, 启用这个属性:

当visibility=hidden时

动态库中的函数默认是被隐藏的即 hidden. 除非显示声明为__attribute__((visibility("default"))).

当visibility=default时

动态库中的函数默认是可见的.除非显示声明为__attribute__((visibility("hidden"))).

JNIEXPORT 主要用于window平台，在安卓平台可不加，去掉即可。

JNICALL:

在类Unix中无定义，在Windows中定义为：_stdcall ，一种函数调用约定

在安卓平台定义如下：

#define JNICALL 什么也没定义

所以，同JNIEXPORT 一样在安卓平台JNICALL可不加，去掉即可。

jobject instance：

在AS中自动为我们生成的JNI方法声明都会带一个这样的参数，这个instance就代表Java中native方法声明所在的类，比如上面arrayTest方法声明在MainActivity中，这里的instance就表示MainActivity实例。

JNIEnv *env：

JNIEnv 指针可是JNI中非常非常重要的一个概念，代表了JNI的环境，JNI层实现的方法都是通过这个指针来调用，通过JNIEnv 指针我们可以调用JNI层的方法访问Java虚拟机，进而操作Java对象。

JNIEnv 指针只在创建它的线程有效，不能跨线程传递，对于这句话的理解我们会在后面涉及线程的时候会再次提到，这里不懂可以看完全文回来再看一下。

我们看下JNIEnv 是怎么定义的：

jni.h中对JNIEnv定义如下：

#if defined(__cplusplus) //c++环境
typedef _JNIEnv JNIEnv;//c++环境中JNIEnv为_JNIEnv 
typedef _JavaVM JavaVM;
#else
typedef const struct JNINativeInterface* JNIEnv;//c环境JNIEnv为const struct JNINativeInterface*
typedef const struct JNIInvokeInterface* JavaVM;
#endif

C++中JNIEnv为_JNIEnv 而 C环境JNIEnv为const struct JNINativeInterface*

我们先看_JNIEnv，定义如下：

struct _JNIEnv {
    
    const struct JNINativeInterface* functions;

#if defined(__cplusplus)

    jint GetVersion()
    { return functions->GetVersion(this); }

    jclass DefineClass(const char *name, jobject loader, const jbyte* buf,
        jsize bufLen)
    { return functions->DefineClass(this, name, loader, buf, bufLen); }

    jclass FindClass(const char* name)
    { return functions->FindClass(this, name); }
    。。。。。
 }

_JNIEnv 是对 const struct JNINativeInterface类型的包装，间接调用了const struct JNINativeInterface 上定义的方法。

我们继续看JNINativeInterface定义：

struct JNINativeInterface {
    。。。
    jint        (*GetVersion)(JNIEnv *);
    jclass      (*DefineClass)(JNIEnv*, const char*, jobject, const jbyte*,
                        jsize);
    jclass      (*FindClass)(JNIEnv*, const char*);
    jmethodID   (*FromReflectedMethod)(JNIEnv*, jobject);
    jfieldID    (*FromReflectedField)(JNIEnv*, jobject);
    /* spec doesn't show jboolean parameter */
    jobject     (*ToReflectedMethod)(JNIEnv*, jclass, jmethodID, jboolean);
    。。。
 }

这里才是接口真正定义的地方，具体的实现在Java虚拟机中。

通过以上分析，我们得出以下结论：

C++中JNIEnv *env相当于 struct _JNIEnv *env 调用方法只需如下方式即可间接调用JNINativeInterface 中方法：

env-> FindClass(JNIEnv*, const char*)

C中JNIEnv *env相当于 JNINativeInterface **env，二级指针，调用方法需要先解引用在调用如下：

(*env)-> FindClass(JNIEnv*, const char*)

明白了以上概念后我们可以继续在native层来实现

JNIEXPORT jint JNICALL
Java_com_wanglei55_ndk_MainActivity_arrayTest(JNIEnv *env,
        jobject instance,jint i,jintArray a1_,jobjectArray a2)

方法了。

使用Java层传递过来的数据

Java层传递过来的数据可能为基本数据类型，数组，对象等，不同数据类型我们要想使用需要不同的处理方式，具体如下。

基本类型数据

Java层传递过来的基本数据类型无需其余操作，直接使用即可。

数组类型数据

数组分为基本数据类型的数组与对象数据类型的数组，比如，int[]与String[]，在Native我们怎么获取数组中的数据呢？如下：

JNIEXPORT jint JNICALL
Java_com_wanglei55_ndk_MainActivity_arrayTest(JNIEnv *env,
        jobject instance,jint i,jintArray a1_,jobjectArray a2) {
    LOGE("i的值为：%d", i);
    // 第二个参数：
    // true：拷贝一个新数组
    // false: 就是使用的java的数组 (地址)
    jint *a1 = env->GetIntArrayElements(a1_, 0);//返回指针，指向数组地址
    jsize len = env ->GetArrayLength(a1_);//获取数组长度
    for (int i = 0; i < len; ++i) {
        LOGE("int数组的值为：%d", *(a1+i));
        //改变java中数组的值，如果下面参数3 mode设置为2则改变不了
        *(a1+i) = 666;
    }
    // 参数3：mode
    // 0:  刷新java数组 并 释放c/c++数组
    // 1 = JNI_COMMIT:只刷新java数组
    // 2 = JNI_ABORT:只释放
    env->ReleaseIntArrayElements(a1_, a1, 0);
    //
    jsize  slen = env->GetArrayLength(a2);//获取数组长度
    for (int i = 0; i < slen; ++i) {
        jstring str = static_cast<jstring>(env->GetObjectArrayElement(a2, i));//获取数组中的数据
        const char* s = env->GetStringUTFChars(str,0);
        LOGE("jni获取java字符串数组：%s", s);
        env->ReleaseStringUTFChars(str, s);
    }
    return 3;
}

上面展示了native层获取java传递过来的数组数据，这里只是遍历了一下，可以看到核心方法都是通过JNIEnv 指针来调用方法操作的，所以JNIEnv 是十分重要的。

对象类型数据

Java传递过来的对象怎么处理呢？这里需要用到反射了，同样也是通过JNIEnv 指针来调用相应方法的，我们在MainActivity添加如下方法：

native void objectTest(Student s, String str);

Student 类如下：

public class Student {

    private int num = 100;

    public int getNum() {
        return num;
    }

    public void setNum(int num) {
        this.num = num;
    }

    public static void printMsg(Card card){//调用方法需要传递Card类
        Log.e("JNI","printMsg Card: "+card.id);
    }

    public static void printMsg(String str){
        Log.e("JNI","printMsg: "+str);
    }
}

Card类：

public class Card {
    int id;

    public Card(int id) {
        this.id = id;
    }
}

都很简单，这里就是演示一下。

接下来我们看下native层怎么获取传递过来的对象数据以及调用其方法，这里我们直接看代码，注释给了详细的说明：

extern "C"
JNIEXPORT void JNICALL
Java_com_wanglei55_ndk_MainActivity_objectTest(JNIEnv *env, jobject instance, jobject bean,
                                               jstring str_) {
    //
    const char *str = env->GetStringUTFChars(str_, 0);
    LOGE("objectTest: %s",str);
    env->ReleaseStringUTFChars(str_, str);
	//bean就是java层传递过来的Student对象
    //反射方式调用bean中的set/get方法
    jclass beanClass = env->GetObjectClass(bean);//获取class
    //修改属性值
    //jfieldID fieldID = env->GetFieldID(beanClass,"num","I");
    //env->SetIntField(bean,fieldID,444);

    //调用set方法设置
    jmethodID setMethodID = env->GetMethodID(beanClass,"setNum","(I)V");//获取方法信息
    env->CallVoidMethod(bean,setMethodID,999);//调用bean中的setMethodID对应的方法
    //调用get方法获取
    jmethodID getMethodID = env->GetMethodID(beanClass,"getNum","()I");//获取方法信息
    jint result = env->CallIntMethod(bean,getMethodID);
    LOGE("调用Student中getNum返回值: %d",result);

    //调用静态方法：public static void printMsg(String str)
    jmethodID staticMID = env->GetStaticMethodID(beanClass,"printMsg","(Ljava/lang/String;)V");
    jstring jstring1 = env->NewStringUTF("JNI中的String");
    env->CallStaticVoidMethod(beanClass,staticMID,jstring1);
    env->DeleteLocalRef(jstring1);//释放

    //调用静态方法：public static void printMsg(Card card)
    jmethodID staticMID2 = env->GetStaticMethodID(beanClass,"printMsg","(Lcom/wanglei55/ndk/Card;)V");
    //创建参数Card
    jclass  cardclz = env->FindClass("com/wanglei55/ndk/Card");//通过完整类名获取class
    jmethodID constructorID = env->GetMethodID(cardclz,"<init>","(I)V");//<init>表示获取构造方法
    jobject cardObj = env->NewObject(cardclz,constructorID,333);//反射创建Card对象
    env->CallStaticVoidMethod(beanClass,staticMID2,cardObj);
    env->DeleteLocalRef(cardObj);
}

上面已经给了详细注释，不再说明，这里需要额外说一下方法的签名。

方法签名

调用GetMethodID与GetStaticMethodID的时候我们需要传递方法的签名信息，怎么配置呢？如下有个对应表：

Java类型	签名
boolean	Z
short	S
float	F
byte	B
int	I
double	D
char	C
long	J
void	V
引用类型	L + 全限定名 + ;
数组	[+类型签名

如果有内部类则用 $ 来分隔如:Landroid/os/FileUtils$FileStatus;

什么意思呢？
比如以Student类中getNum()方法为例，其定义如下：

public int getNum()

方法调用不用传递参数，返回值为int类型，int对应签名为I，大写的啊，所以方法签名为"()I"，()里面填写参数对应的签名，()右面紧跟方法返回值签名。

再来个复杂的，比如如下方法：

String getInfo(long[], List list);

签名是什么呢？其签名为：

"([JLjava/util/List)Ljava/lang/String;"

其中 “[J” 代表long[]的签名，“Ljava/util/List” 代表List list的签名，“Ljava/lang/String;” 代表返回值String的签名。

四、静态注册与动态注册以及JNI_OnLoad方法

静态注册

像上面我们在java层定义native方法：

native void objectTest(Student s, String str);

然后在JNI层定义对应方法：

JNIEXPORT void JNICALL
Java_com_wanglei55_ndk_MainActivity_objectTest(JNIEnv *env, jobject instance, jobject bean,jstring str_) {
	。。。
}

当我们在Java中调用objectTest(Student s, String str)方法时，就会从JNI层寻找Java_com_wanglei55_ndk_MainActivity_objectTest(JNIEnv *env, jobject instance, jobject bean,jstring str_) 方法，并为二者建立联系。
静态注册就是根据方法名，将Java层native方法和JNI层对应方法建立关联，这种方式就是静态注册，静态注册有如下缺点：

JNI层方法名很长
第一次调用native方法会比较耗时，需要查找对应方法建立联系（通过指针记录方法）

有没有一种方式在加载的时候就建立起二者的联系呢？这样第一次调用native方法的时候就不需要查找了，这种方式就是动态注册。

动态注册

动态注册可以在加载的时候就建立起java层native方法与JNI层方法的联系，那具体怎么建立联系呢？加载的时候是指什么时候？

我们在调用动态库so中方法的时候都会先加载对应so库，比如：

    static {
        System.loadLibrary("native-lib");
    }

在加载native-lib动态库的时候JVM会检查对应C/C++文件中是否有int JNI_OnLoad(JavaVM *vm, void *reserved)方法，有的话则会调用这个方法，在这个方法里面我们可以做一些初始化的操作，进而可以动态注册一些方法。

接下来我们具体操作一下看看怎么动态注册：

首先java层同样定义native方法，如下：

native  void dynamicJavaTest();
native  int dynamicJavaTest2(int i);

接下来在JNI层定义对应方法：

void dynamicTest(){
    LOGE("JNI dynamicTest");
}

jint dynamicTest2(JNIEnv *env, jobject instance,jint i){
    LOGE("JNI dynamicTest2:%d",i);
    return 9999;
}

这里我并没有把方法名设置为一样，方法名你可以随便起，如果想接收JNIEnv *env, jobject instance参数可以在方法上加上，Jvm调用的时候会传递这两个参数给JNI层方法，不想接收也可以去掉。

java层方法与JNI层怎么建立起关联呢？接下来我们还需要定义JNINativeMethod类型的数组，将两者对应起来，JNINativeMethod定义在jni.h中定义如下：

typedef struct {
    const char* name;//java层的方法名
    const char* signature;//java层方法的签名
    void*       fnPtr;//JNI层对应方法的指针
} JNINativeMethod;

这里我们将java层dynamicJavaTest方法与JNI层dynamicTest对应
java层dynamicJavaTest2方法与JNI层dynamicTest2对应

所以数组定义如下：

static const JNINativeMethod methods[] = {
        {"dynamicJavaTest","()V",(void*)dynamicTest},
        {"dynamicJavaTest2","(I)I",(int*)dynamicTest2},
};

接下来就可以在JNI_OnLoad方法中动态注册了：

static const char *mClassName = "com/wanglei55/ndk/MainActivity";

JavaVM *_vm;//记录JavaVM 

int JNI_OnLoad(JavaVM *vm, void *reserved){
    //
    LOGE("JNI_Onload");
    //
    _vm = vm;
    // 获得JNIEnv
    JNIEnv *env = 0;
    // 小于0 失败 ，等于0 成功
    int r = vm->GetEnv((void**)&env,JNI_VERSION_1_4);
    if (r != JNI_OK){
        return -1;
    }
    //获得 class对象
    jclass jcls = env->FindClass(mClassName);
    //动态注册方法
    env->RegisterNatives(jcls,methods, sizeof(methods)/ sizeof(JNINativeMethod));
    return JNI_VERSION_1_4;// 返回native 组件使用的 JNI 版本
}

核心就是调用RegisterNatives方法来完成动态注册的逻辑，到此动态注册就完成了，此外动态注册不用定义那么长的方法。

在安卓系统源码中JNI层大量使用了动态注册方法而不是静态注册，静态注册多用于平常NDK的开发。

五、native线程调用Java

native调用java需要用到JNIEnv指针，而JNIEnv是由Jvm传入与线程相关的变量，如果我们在native中开启一个线程完成工作后回调java层方法怎么办呢？可以通过JavaVM的AttachCurrentThread方法来获取到当前线程中JNIEnv指针。

接下来我们看一下怎么操作。

java层定义native方法与回调的方法：

    public void callBack(){
        if (Looper.myLooper() == Looper.getMainLooper()){
            Toast.makeText(this,"MainLooper",Toast.LENGTH_SHORT).show();
        }else{
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    Toast.makeText(MainActivity.this,"runOnUiThread",Toast.LENGTH_SHORT).show();
                }
            });
        }
    }

	native void testThread();

JNI层采用静态注册的方式注册对应方法：

jobject _instance;

void* threadTask(void* args){
    // native线程 附加 到 Java 虚拟机
    JNIEnv *env;//JNIEnv *是与线程有关的
    //调用JavaVM 的AttachCurrentThread方法来获取与线程有关的JNIEnv
    jint i = _vm->AttachCurrentThread(&env,0);//JNI_OnLoad会传递过来JavaVM *vm参数
    if (i != JNI_OK){
        return nullptr;
    }
    //回调
    //获得MainActivity的class对象
    jclass cls = env->GetObjectClass(_instance);
    jmethodID  updateUI = env->GetMethodID(cls,"callBack","()V");
    env->CallVoidMethod(_instance,updateUI);
    //释放内存
    env->DeleteGlobalRef(_instance);
    //退出线程，释放线程资源
    _vm->DetachCurrentThread();
    return 0;
}

extern "C"
JNIEXPORT void JNICALL
Java_com_wanglei55_ndk_MainActivity_testThread(JNIEnv *env, jobject instance) {

    pthread_t pid;
    //启动线程
    _instance = env->NewGlobalRef(instance);
    pthread_create(&pid,0,threadTask,0);//记得引入头文件 #include <pthread.h>
}

native线程中使用JNIEnv一定要记得获取当前线程的JNIEnv，因为不同线程的JNIEnv是不同的，同时使用完记得调用DetachCurrentThread()方法释放线程资源。

六、总结

好了，本篇算是NDK开发的入门篇，介绍了一些基础的操作，一定要记住，如果想深入NDK层先把C/C++语言基础打好，否则上面代码看起来很蒙圈。

汪磊的博客

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
Android：JNI与NDK(一)

本篇目录一、前言安卓开发中很多场景需要用到NDK来开发，比如，音视频的渲染，图像的底层绘制等等，安卓绝大部分核心代码都是在Native层来完成，也就是用C/C++来完成，有的时候我们看系统源码的时候追着追着就发现最终调用一个native声明的方法，接下来就需要深入native层来查看具体逻辑了，那java代码是怎么调用native层代码的呢？或者说java是怎么调用C/C++代码的呢？这里就用...
复制链接

扫一扫

专栏目录