记录一次Android NDK与JNI使用基础

准备工作

  • 1.开发环境


    developEnvironment.png

  • 2.AndroidStudio版本


    ASVersion.png

  • 3.在SDKManager中下载NDK工具


    ndk.png

静态注册Native函数

  1. 创建Android项目

2.创建native方法的工具类JniTest，代码如下

package com.xc.jnitest.exercise;

public class JniTest {

    public  native String get();

    public native void set(String str);
}

3.修改MainActivity以及layout文件
activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/textview1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        android:textSize="20sp"
        android:textStyle="bold"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</android.support.constraint.ConstraintLayout>

MainActivity

public class MainActivity extends AppCompatActivity {
    TextView mText;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mText = findViewById(R.id.textview1);

        JniTest jniTest = new JniTest();

        mText.setText(jniTest.get());
    }
}

4.生成.class文件

  • 可以在Terminal中使用 “javac com/xc/jnitest/exercise/JniTest.java”命令生成.class文件
  • 在AndroidStudio中可以直接Build-> Make Project生成,如下图
    make_project.png

使用Terminal生成的.class文件在同级目录下，使用Build->Make project生成的在build目录下，如下图

使用javac生成.png

使用Build生成.png

5.在Terminal中cd到相应目录下，执行javah -jni命令生成.h头文件

  • 在java目录下执行javah -jni com.xc.jnitest.exercise.JniTest命令
  • 在build/intermediates/javac/debug/compileDebugJavaWithJavac/classes目录下执行 javah -jni com.xc.jnitest.exercise.JniTest命令

生成对应的.h头文件如下图

头文件.png

.h文件内容如下：

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

#ifndef _Included_com_xc_jnitest_exercise_JniTest
#define _Included_com_xc_jnitest_exercise_JniTest
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_xc_jnitest_exercise_JniTest
 * Method:    get
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_xc_jnitest_exercise_JniTest_get
  (JNIEnv *, jobject);

/*
 * Class:     com_xc_jnitest_exercise_JniTest
 * Method:    set
 * Signature: (Ljava/lang/String;)V
 */
JNIEXPORT void JNICALL Java_com_xc_jnitest_exercise_JniTest_set
  (JNIEnv *, jobject, jstring);

#ifdef __cplusplus
}
#endif
#endif

JNIEnv*:表示一个纸箱JNI环境的指针，可以通过它来访问JNI提供的接口方法；
jobject：表示Java对象中的this
JNIEXPORT和JNICALL：他们是JNI中所定义的宏，可以在jni.h这个头文件中查找到。
jstring： 是返回值类型
Java_com_xc_jnitest_exercise 是包名
JniTest： 是类名
get： 是方法名

  • 上边只是让你更理解创建步骤，如果嫌麻烦，可以直接使用
    javah -d ../jni com.xc.jnitest.exercise.JniTest
    创建.h头文件，当然这里就可以省略生成.class文件的步骤了，其中
    -d ../jni 是指定要生成的头文件到那个目录下

6.在main目录下创建一个jni文件夹，将刚才生成的.h文件剪切过来。在jni目录下新建一个c++文件。命名为jni-test.cpp。（注：c文件的后缀为.c,c++文件后缀为.cpp）
如下图：

目录.png

7.编写jni-test.cpp文件

#include <jni.h>
#include <stdio.h>

#include "com_xc_jnitest_exercise_JniTest.h"

JNIEXPORT jstring JNICALL Java_com_xc_jnitest_exercise_JniTest_get
  (JNIEnv *env, jobject obj ){
    return env->NewStringUTF("Hello from JNI !");
  }

/*
 * Class:     com_xc_jnitest_exercise_JniTest
 * Method:    set
 * Signature: (Ljava/lang/String;)V
 */
JNIEXPORT void JNICALL Java_com_xc_jnitest_exercise_JniTest_set
  (JNIEnv *env, jobject obj, jstring string){
    char* str = (char*) env->GetStringUTFChars(string,NULL);
    env->ReleaseStringUTFChars(string,str);
  }
  • #inclued "com_xc_jnitest_exercise_JniTest.h" 添加头文件
  • 实现两个方法方法
  1. 在jni目录下添加Android.mk文件
LOCAL_PATH := $(call my-dir)  //

include $(CLEAR_VARS)

LOCAL_MODULE    := jni-test

LOCAL_SRC_FILES := jni-test.cpp

include $(BUILD_SHARED_LIBRARY)
  • LOCAL_PATH := $(call my-dir)：每个Android.mk文件必须以定义开始。它用于在开发tree中查找源文件。宏my-dir则由Build System 提供。返回包含Android.mk目录路径。
  • include $(CLEAR_VARS) ：CLEAR_VARS变量由Build System提供。并指向一个指定的GNU Makefile，由它负责清理很多LOCAL_xxx。例如LOCAL_MODULE，LOCAL_SRC_FILES，LOCAL_STATIC_LIBRARIES等等。但不是清理LOCAL_PATH。这个清理是必须的，因为所有的编译控制文件由同一个GNU Make解析和执行，其变量是全局的。所以清理后才能便面相互影响。
  • LOCAL_MODULE := jni-test：LOCAL_MODULE模块必须定义，以表示Android.mk中的每一个模块。名字必须唯一且不包含空格。Build System 会自动添加适当的前缀和后缀。例如，demo，要生成动态库，则生成libdemo.so。但请注意：如果模块名字被定义为libabd，则生成libabc.so。不再添加前缀。
  • LOCAL_SRC_FILES := ndkdemotest.c：这行代码表示将要打包的C/C++源码。不必列出头文件，build System 会自动帮我们找出依赖文件。缺省的C++ 源码的扩展名为.cpp。
  • include $(BUILD_SHARED_LIBRARY)：BUILD_SHARED_LIBRARY是Build System提供的一个变量，指向一个GUN Makefile Script。它负责收集自从上次调用include $(CLEAR_VARS)后的所有LOCAL_xxxxinx。并决定编译什么类型
    • BUILD_STATIC_LIBRARY：编译为静态库
    • BUILD_SHARED_LIBRARY：编译为动态库
    • BUILD_EXECUTABLE：编译为Native C 可执行程序
    • BUILD_PREBUILT：该模块已经预先编译

9.配置app module的build.gradle文件

android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "com.xc.jnitest"
        minSdkVersion 21
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

        ndk{
            moduleName "jni-test"
            abiFilters "armeabi-v7a", "x86"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    
    externalNativeBuild {
        ndkBuild {
            path 'src/main/jni/Android.mk'
        }
    }
    sourceSets.main {
        jni.srcDirs = []
        jniLibs.srcDirs = ['src/main/jniLibs']
    }
}

配置后就可以生成.so文件了（PS：项目Build之后）

  1. 加载so库
package com.xc.jnitest.exercise;

public class JniTest {

    static{
        System.loadLibrary("jni-test");
    }

    public static native String get();

    public static native void set(String str);
}

11.运行项目


running.png

动态注册Native函数

  • 不必忍受冗长的函数名，自由命名函数名，在JNI_OnLoad方法里进行注册。

1.修改生成后的.h头文件名为jni-test.h,如下

修改头文件名.png

修改.h文件方法名

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

#ifndef _Included_com_xc_jnitest_exercise_JniTest
#define _Included_com_xc_jnitest_exercise_JniTest
#ifdef __cplusplus
extern "C" {
#endif

jstring get (JNIEnv *, jobject);

void set (JNIEnv *, jobject, jstring);

#ifdef __cplusplus
}
#endif
#endif

2.修改.cpp文件如下

#include <jni.h>
#include <stdio.h>

#include "jni-test.h"

jstring get(JNIEnv *env, jobject obj) {
    return env->NewStringUTF("Hello from JNI !");
}


void set(JNIEnv *env, jobject obj, jstring string) {
    char *str = (char *) env->GetStringUTFChars(string, NULL);
    env->ReleaseStringUTFChars(string, str);
}

3.添加参数映射函数

//参数映射表
static JNINativeMethod getMethods[] = {
        {"get", "()Ljava/lang/String;", (void *) get},
        {"set", "(Ljava/lang/String;)", (void *) set},
};

它的返回值是JNINativeMethod类型：
JNI允许我们提供一个函数映射表，注册给Java虚拟机，这样JVM就可以用函数映射表来调用相应的函数。这样就可以不必通过函数名来查找需要调用的函数了。Java与JNI通过JNINativeMethod的结构来建立联系，它被定义在jni.h中，其结构内容如下：

typedef struct { 
    const char* name; 
    const char* signature; 
    void* fnPtr; 
} JNINativeMethod;
  • 第一个变量name，代表的是Java中的函数名
  • 第二个变量signature，代表的是Java中的参数和返回值
  • 第三个变量fnPtr，代表的是的指向C函数的函数指针

第二个变量signature定义如下：
(参数1类型标示；参数2类型标示；参数3类型标示...)返回值类型标示
当参数为引用类型的时候，参数类型的标示的根式为"L包名"，其中包名的.(点)要换成"/"，比如String就是Ljava/lang/String，Menu为Landroid/view/Menu,如果返回值是void,对应的签名就是V。
如果是基本类类型，其签名如下(除了boolean和long，其他都是首字母大写)：

类型标示 Java类型
Z boolean
B byte
C char
S short
I int
J long
F float
D double

数组类型：

类型标示 Java类型
[签名 数组
[i int[]
[Ljava/lang/Object String[]
  • 可以使用JDK的javap -s com.xc.jnitest.exercise.JniTest直接查看他的signature，这里的com.xc.jnitest.exercise.JniTest为class文件路径

4.注册native方法

//native类路径
static const char *className = "com/com/xc/jnitest/exercise/JniTest";

//注册native方法
static int registerNatives(JNIEnv *engv) {
    jclass clazz;
    clazz = engv->FindClass(className);   //找到native类
    if (clazz == NULL) {
        return JNI_FALSE;
    }
    //int len = sizeof(methods) / sizeof(methods[0]);
    if (engv->RegisterNatives(clazz, getMethods,
                              sizeof(getMethods) / sizeof(getMethods[0])) <
        0) {
        return JNI_FALSE;
    }
    return JNI_TRUE;
}

JNIEXPORT jint JNI_OnLoad(JavaVM *vm, void *reserved) {
    JNIEnv *env = NULL;
    jint result = -1;
    if (vm->GetEnv((void **) &env, JNI_VERSION_1_6) != JNI_OK) {
        return result;
    }
    assert(env != NULL);
    //为了方便管理我们将不同java类中的native方法分别注册
    if (registerNatives(env) < 0) {  //注册native方法
        return result;
    }
    //如果还有别的native类，可继续在此进行注册
    return JNI_VERSION_1_6;
}

jni-test.cpp完整代码如下

#include <jni.h>
#include <stdio.h>
#include <assert.h>

#include "jni-test.h"

jstring get(JNIEnv *env, jobject obj) {
    return env->NewStringUTF("Hello from JNI !");
}


void set(JNIEnv *env, jobject obj, jstring string) {
    char *str = (char *) env->GetStringUTFChars(string, NULL);
    env->ReleaseStringUTFChars(string, str);
}

//参数映射表
static JNINativeMethod getMethods[] = {
        {"get", "()Ljava/lang/String;", (void *) get},
        {"set", "(Ljava/lang/String;)V", (void *) set},
};

//native类路径
static const char *className = "com/xc/jnitest/exercise/JniTest";

//注册native方法
static int registerNatives(JNIEnv *engv) {
    jclass clazz;
    clazz = engv->FindClass(className);   //找到native类
    if (clazz == NULL) {
        return JNI_FALSE;
    }
    //int len = sizeof(methods) / sizeof(methods[0]);
    if (engv->RegisterNatives(clazz, getMethods,
                              sizeof(getMethods) / sizeof(getMethods[0])) <
        0) {
        return JNI_FALSE;
    }
    return JNI_TRUE;
}

JNIEXPORT jint JNI_OnLoad(JavaVM *vm, void *reserved) {
    JNIEnv *env = NULL;
    jint result = -1;
    if (vm->GetEnv((void **) &env, JNI_VERSION_1_6) != JNI_OK) {
        return result;
    }
    assert(env != NULL);
    //为了方便管理我们将不同java类中的native方法分别注册
    if (registerNatives(env) < 0) {  //注册native方法
        return result;
    }
    //如果还有别的native类，可继续在此进行注册

    return JNI_VERSION_1_6;
}

5.齐活，运行！

native代码反调用Java层代码

1.获取class对象：

  • jclass FindClass(const char* clsName)：
    通过类的名称(类的全名，这时候包名不是用'"."点号而是用"/"来区分的)来获取jclass。比如:
jclass jcl_string=env->FindClass("java/lang/String");
  • jclass GetObjectClass(jobject obj)
    通过对象实例来获取jclass，相当于Java中的getClass()函数
  • jclass getSuperClass(jclass obj)
    通过jclass可以获取其父类的jclass对象

2.获取属性方法
在Native本地代码中访问Java层的代码，一个常用的常见的场景就是获取Java类的属性和方法。所以为了在C/C++获取Java层的属性和方法，JNI在jni.h头文件中定义了jfieldID和jmethodID这两种类型来分别代表Java端的属性和方法。在访问或者设置Java某个属性的时候，首先就要现在本地代码中取得代表该Java类的属性的jfieldID，然后才能在本地代码中进行Java属性的操作，同样，在需要调用Java类的某个方法时，也是需要取得代表该方法的jmethodID才能进行Java方法操作。

  • GetFieldID/GetMethodID
    获取某个属性/某个方法
  • GetStaticFieldID/GetStaticMethodID
    获取某个静态属性/静态方法
    方法实现如下：
jfieldID GetFieldID(JNIEnv *env, jclass clazz, const char *name, const char *sig);
jmethodID GetMethodID(JNIEnv *env, jclass clazz, const char *name, const char *sig);
jfieldID GetStaticFieldID(JNIEnv *env, jclass clazz, const char *name, const char *sig);
jmethodID GetStaticMethodID(JNIEnv *env, jclass clazz,const char *name, const char *sig);

3.构造对象
常用的JNI中创建对象的方法如下：

jobject NewObject(jclass clazz, jmethodID methodID, ...)

比如有我们知道Java类中可能有多个构造函数，当我们要指定调用某个构造函数的时候，会调用下面这个方法

jmethodID mid = (*env)->GetMethodID(env, cls, "<init>", "()V");
obj = (*env)->NewObject(env, cls, mid);

即把指定的构造函数传入进去即可。
现在我们来看下他上面的两个主要参数

  • clazz：是需要创建的Java对象的Class对象
  • methodID：是传递一个方法ID

简化代码如下：

jobject NewObjectA(JNIEnv *env, jclass clazz, 
jmethodID methodID, jvalue *args);

这里多了一个参数，即jvalue *args，这里是args代表的是对应构造函数的所有参数的，我们可以应将传递给构造函数的所有参数放在jvalues类型的数组args中，该数组紧跟着放在methodID参数的后面。NewObject()收到数组中的这些参数后，将把它们传给编程任索要调用的Java方法。

如果参数不是数组怎么处理：

jobject NewObjectV(JNIEnv *env, jclass clazz, 
jmethodID methodID, va_list args);

这个方法和上面不同在于，这里将构造函数的所有参数放到在va_list类型的参数args中，该参数紧跟着放在methodID参数的后面。

总结

1.静态注册native函数

  • 第1步：在Java中先声明native方法
  • 第2步：编译Java源文件javac得到.class文件
  • 第3步：通过javah -jni命令导出JNI的.h头文件，添加.c或.cpp文件，实现函数方法
  • 第4步：使用Java需要交互的本地代码，实现在Java中声明的Native方法
  • 第5步：添加Android.mk文件，修改build.gradle文件，将本地代码编译成动态库
  • 第6步：通过Java命令执行Java程序，最终实现Java调用本地代码。

2.动态注册native函数， 在静态注册的基础上：

  • 修改简化.h文件的方法名与方法
  • 修改简化.cpp文件的方法名
  • 添加映射函数与注册函数

项目git地址:https://github.com/x-fp/JniTest

参考文章：https://www.jianshu.com/p/87ce6f565d37
这篇文章写得非常详细，感谢作者的帮助

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 213,335评论 6赞 492
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,895评论 3赞 387
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 158,766评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,918评论 1赞 285
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 66,042评论 6赞 385
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 50,169评论 1赞 291
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,219评论 3赞 412
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,976评论 0赞 268
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,393评论 1赞 304
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,711评论 2赞 328
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,876评论 1赞 341
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,562评论 4赞 336
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,193评论 3赞 317
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,903评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,142评论 1赞 267
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,699评论 2赞 362
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,764评论 2赞 351

推荐阅读更多精彩内容