Android JNI 入门 含完整Demo

• 什么是 JIN
• 环境配置
• 生成 C 头文件详解
• native 层改变 java 属性的值(非静态)
• native 层改变 java 属性的值(静态)
• native 调用java静态方法
• 属性签名

什么是 JIN

JNI 全称:java native interface (java 本地接口),是 java 和 C/C++通信的’翻译官’,

百度百科

环境配置

下载 NDK(side by side)
CMake 后面需要用,最好下载下来

新建项目:

选择 Native C++然后一直下一步即可!

生成 C 头文件详解

在 mainActivity 中定义 int 类型的常量,会在 C 的头文件中生成宏

自动生成头C 的头文件:

第一步:进入到项目中的 java 目录

我的地址为:
cd Desktop/AndroidProject/JNI/app/src/main/java/

可以通过 Reveal in Finder 快速打开当前文件

\

第二步:输入java指令

javah com.example.jni.MainActivity
(javah 类名.包名)
复制代码

然后就看到了生成的.h文件

\

MainActivity中定义的常量,自动生成的宏!

.h文件内容:

//JNI 头文件
#include <jni.h>

//解决循环拷贝问题
#ifndef _Included_com_example_jni_MainActivity //如果没有定义这个宏
#define _Included_com_example_jni_MainActivity//就定义这个宏

#ifdef __cplusplus //如果是 C++环境,就使用 C 的环境
extern "C" {//全部采用 C 的方式,采用 C 是为了不准你函数重载(解决函数名冲突的问题)
#endif
#undef com_example_jni_MainActivity_A

//自动检测 MainActivity 生成宏
#define com_example_jni_MainActivity_A 234L

//函数的声明
extern "C" JNIEXPORT jstring JNICALL Java_com_example_jni_MainActivity_getString
  (JNIEnv *, jobject);



#ifdef __cplusplus//如果是 C++ 什么事情都不干
}
#endif
#endif
复制代码

这里注释添加的非常清楚,就不在啰嗦了,如若不懂,评论区留言哦!

函数实现文件:

//extern "C" JNIEXPORT jstring JNICALL Java_com_example_jni_MainActivity_getString
// (JNIEnv *, jobject){}
//=================================请看如下注释=================================


//JNIEnv 是 C++ 的最终会调用到 C 的 JNINativeInterface方法 ,所以必须采用 C 的方式(extern "C")
extern "C" //采用 C 的编译方式

JNIEXPORT //标记该方法会被外部调用(VS 会报错,AS 不会报错)

jstring // java中方法的返回值,
// 这里返回 jstring,表示 java 中是 String 类型
//如果是 jint则表示 java 中是 int 类型

JNICALL//表示是 JIN 的标记(这个可以去掉)

//函数名,由 JDK设计的(JNI 是 java 的技术,不是 native 的技术)
Java_com_example_jni_MainActivity_getString
        (JNIEnv *env, jobject job) {
    /**
     * 参数一:(JNIEnv):是 Java 与 C/C++通信最重要的东西(精华)
     * 参数二 :情况一(jobject)非静态:谁调用它,就是谁的实例,这里 MainActivity 调用,job 就是 MainActivity(this)
     *      :情况二:(jclass)静态: 谁调用它,就是谁的class,这里 MainActivity 调用,jclass 就是 MainActivity.class
     */
}
复制代码

参数一: JNIEnv这个参数非常重要,是 JNI 的精华,这个参数最终会调用到 C 的结构体(JNINativeInterface)

这里需要注意的就是第二个参数:

• 当为非静态的时候,生成的是jobject对象
• 当为静态的时候,生成的是jclass对象

native 层改变 java 属性的值(非静态)

实现效果:java 属性值为”张三”,通过调用 native 函数,修改为李四

 public String name = "张三";
复制代码

在 MainActivity 中创建调用 native 的方法

 //通过 native 修改名字 为"李四"
public native void changeName();
复制代码

native 层代码:

我直接在实现文件写了!

//NDK 工具链中的 log库(用来打印)
#include <android/log.h>

//定义宏,用来打印结果
#define TAG "szj"
//...我都不知道要传什么,可以借助 JNI 中的宏来传入
#define LOGD(...)__android_log_print(ANDROID_LOG_DEBUG,TAG,__VA_ARGS__);
#define LOGI(...)__android_log_print(ANDROID_LOG_INFO,TAG,__VA_ARGS__);
#define LOGE(...)__android_log_print(ANDROID_LOG_ERROR,TAG,__VA_ARGS__);


//函数具体实现
extern "C"
JNIEXPORT void JNICALL
Java_com_example_jni_MainActivity_changeName(JNIEnv *env, jobject thiz) {
    /**
     *  获取 class
     */
    jclass j_cls = env->GetObjectClass(thiz);

    /**
     * jfieldID GetFieldID(jclass clazz, const char* name, const char* sig)
     * 参数一:MainActivity.class
     * 参数二:属性名
     * 参数三:属性签名 L 表示引用类型
     */
    jfieldID j_fid = env->GetFieldID(j_cls, "name", "Ljava/lang/String;");


    /**
     * jobject GetObjectField(jobject obj, jfieldID fieldID)
     * 把 java 属性变成 jstring 类型
     * 参数一:jobject
     * 参数二:签名 ID
     * static_cast<jstring>强制转换为 jstring 类型
     */
    jstring j_str = static_cast<jstring>(env->GetObjectField(thiz, j_fid));

    /**
     * 将JNI 的jstring 转换为C++的 char 类型
     * const char* GetStringUTFChars(jstring string, jboolean* isCopy)
     *  打印字符串
     *  参数一:需要转换的字符串
     *  参数二:不知道是啥
     */
    const char *chars = env->GetStringUTFChars(j_str, NULL);
    LOGD("native %s", chars);
    LOGI("native %s", chars);
    LOGE("native %s", chars);

    jstring st = env->NewStringUTF("李四");

    /**
     * void SetObjectField(jobject obj, jfieldID fieldID, jobject value)
     *  修改成 李四
     *  参数一:jobject
     *  参数二:签名 ID
     *  参数三:修改后的 jstring
     */
    env->SetObjectField(thiz, j_fid, st);
}
复制代码

和 java 反射有异曲同工之妙;

思路:

• 通过GetObjectClass()获取jclass (主要以 j 开头的都是 JNI 的属性 例如:jclass,jstring,jfieldID等)
• 通过GetFieldID() 获取到属性名的 ID
• 然后通过GetObjectField()将 java 上的 String 改变为 JNI 认识的 jstring
• 最后修改通过SetObjectField()修改为’李四’

属性签名最后会说!

使用:

运行结果为:

native 层改变 java 属性的值(静态)

native 层改变静态属性:

//通过 native 修改年龄+10
public static native void changeAge();
复制代码

vative 层代码:

extern "C"
JNIEXPORT void JNICALL
Java_com_example_jni_MainActivity_changeAge(JNIEnv *env, jclass clazz) {
    /**
     * 参数三:基本类型签名(int 对应 I)
     */
    jfieldID j_id = env->GetStaticFieldID(clazz, "age", "I");

    /**
     * 获取静态int 类型的属性
     *jint GetStaticIntField(jclass clazz, jfieldID fieldID)
     * 参数一:jclass
     * 参数二:静态 属性ID
     */
    jint j_age = env->GetStaticIntField(clazz, j_id);

    //修改参数
    j_age += 10;

    /**
     * 修改值后,在设置回去新的值
     * void SetStaticIntField(jclass clazz, jfieldID fieldID, jint value)
     * 参数一:jclass
     * 参数二:静态属性 ID
     * 参数三:新的静态值
     */
    env->SetStaticIntField(clazz, j_id, j_age);
}
复制代码

使用:

运行效果:

native 调用java静态方法

java层:

	public int add(int number1,int number2){
        return number1+ number2;
    }
    //native 调用 java 方法
    public native int nativeAdd();
复制代码

native 层:

extern "C"
JNIEXPORT jint JNICALL
Java_com_example_jni_MainActivity_nativeAdd(JNIEnv *env, jobject thiz) {
    /**
     * 通过 jobject 获取 jclass
     * jclass GetObjectClass(jobject obj)
     */
    jclass j_c = env->GetObjectClass(thiz);

    /**
     * 获取方法 ID;
     * jmethodID GetMethodID(jclass clazz, const char* name, const char* sig)
     * 参数一:jclass 对象
     * 参数二:调用的方法名
     * 参数三:参数与返回值签名
     */
    jmethodID jmethodId = env->GetMethodID(j_c, "add", "(II)I");

    /**
     * jint(*CallIntMethod)(JNIEnv*, jobject, jmethodID, ...);
     *  调用 java 的方法返回值为int
     */
    jint jint1 = env->CallIntMethod(thiz, jmethodId, 4, 2);
    LOGE("native %d", jint1);

    //方法结束必须返回 0 ,否则会报以下错误,(不要问,问就是找了 20 分钟)
    //Fatal signal 5 (SIGTRAP), code 1 (TRAP_BRKPT), fault addr 0x7675a751dc in tid 18347 (com.example.jni),
    // pid 18347 (com.example.jni)
    return 0;
}
复制代码

运行结果为:

属性签名

八大基本类型签名:

java	native
boolean	Z
short	S
int	I
byte	B
double	D
float	F
char	C
long	J

方法举例:

java	native
void sum(int a,int b)	(II)V
void sum(int a,int b,int c)	(III)V

数组举例:

java	native
array int[]	[ I
array int[][]	[ [ I
array float[][][]	[ [ [ F

也可以通过指令来获取一个类中的所有签名:

第一步:进入到.class 目录:

进入到这个目录下:

我的地址为:
 cd /Users/shizhenjiang/Desktop/AndroidProject/JNI/app/build/intermediates/javac/debug/classes/com/example/jni
复制代码

然后输入指令:

javap -s -p xxx.class
复制代码

最终结果为:

• 红色框:我输入的指令
• 绿色框:方法/属性名 descriptor为签名

\

注意:

如果 so 库报错,把其他两个注释掉

同理,如果你想看 JNI 基本使用(native-simple-lib.cpp)的代码,那么吧 JNI 进阶和 QQ语音实战的代码注释掉!

现在只能有一个 cpp 文件存在

其他 JNI 文章:

第二篇:Android JNI 进阶(含完整 Demo)

第三篇:Android JNI QQ 搞怪语音实战 (含完整 Demo)

完整代码

原创不易,您的点赞就是对我最大的支持~