JNI&NDK编程小结及建议

前言

由于网上关于JNI/NDK相关的知识点介绍的比较零散而且不具备参照性,所以写了这篇JNI/NDK笔记,便于作为随时查阅的工具类型的文章,本文主要的介绍了在平时项目中常用的命令、JNI数据类型、签名等,便于查阅相关资料。文末相关参考资料比较适合刚接触或者不熟悉Android NDK开发的朋友参阅。

常用命令

javac 编译java源文件生成.class文件

由于JNI对应的头文件由javah工具根据对应的.class文件生成,所以在进行JNI编程之前,写好Java代码后需要先编译,在使用javah生成对应的头文件

javah -jni自动生成头文件

举例说明:

  • 生成普通的JNI头文件

    javah -classpath path -jni -d outputdirpath com.mrljdx.JavaNativeCode
    
  • 在Java函数中包含Android相关的参数代码,则需要在classpath中添加android.jar包的绝对路径地址

    javah -classpath path:$ANDROID_HOME/path/android.jar -jni -d outputdirpath com.mrljdx.JavaNativeCodeWithAndroid
    

javap -s -p 查看函数签名

-s: 显示签名(只显示public类型的签名) -p:显示所有函数、成员变量的签名

举例说明:

javap -classpath pacakage_path_dir -s -p com.mrljdx.JavaCode

JNI数据类型和类型签名

数据类型

JNI的数据类型包括:基本类型引用类型。这一点和Java的语言特性一致,基本类型包括jboolean、jchar、jint、jlong、jbyte、jshort、jfloat、jdouble、void,与Java类型的对应关系如下:

JNI类型 Java类型 描述
jboolean boolean 无符号8位整型
jbyte byte 有符号8位整型
jchar char 无符号16位整型
jshort short 有符号16位整型
jint int 32位整型
jlong long 64位整型
jfloat float 32位整型
jdouble double 64位整型
void void 无类型

JNI中引用类型主要有类、对象和数组,这点也上符合Java的语法规范,对应的关系如下:

JNI 类型 Java引用类型 描述
jobject Object Object类型
jclass Class Class类型
jstring String String类型
jobjectArray Object[] 对象数组
jbooleanArray boolean[] boolean数组
jbyteArray byte[] byte数组
jcharArray char[] char数组
jshortArray short[] short数组
jintArray int[] int数组
jlongArray long[] long数组
jfloatArray float[] float数组
jdoubleArray double[] double数组
jthrowable Throwable Throwable

JNI类型签名

JNI的类型签名标识了一个特定的Java类型,这个类型可以是类和方法,也可以是数据类型。

  • 类型签名
    类的签名采用"L+包名+类名+;"标识,包名中将.替换为/即可。
    比如String类的签名:
    Ljava/lang/String;
    注意末尾的;属于签名的一部分。
    再比如Android中Context类的签名:
    Landroid/content/Context;
  • 基本数据类型签名
    基本数据类型的签名采用一系列大写字母来标识,如下:
Java类型 签名
boolean Z
byte B
char C
short S
int I
long J
float F
double D
void V

可以发现除了 long基本数据类型的签名为J之外其他的都比较容易辨识,估计是由于之前的类类型的签名开头为L+包名+类名+;设计者为了区分所以签名为J

  • 数组的类型签名
    数组的类型签名比起类类型和基本数据类型的要稍微复杂一点,不过还是很好理解的。对于数组来说,它的签名为[+类型签名,举例说明:
    String[] 数组类型对应的签名:
    [Ljava/lang/String;
    可以发现,就是在String的类签名前加了个[
    同理基本数据类型签名int[]的签名:
    [I
    注意这里基本类型后面是不带分号的。
    那么多维数组呢?可以类推,int[][] 的签名为[[I ,而String[][]的签名为[[Ljava/lang/String;
  • 方法的签名
    在JNI中会经常需要在C/C++代码中调用Java的函数,这时候就会用到方法的签名。方法的签名为(+参数类型签名+)+返回值类型签名,比如:
    方法: boolean login(String username,String password)的方法签名如下:
    (Ljava/lang/String;Ljava/lang/String)B 如果这里不理解的话,请再去看看之前关于基本类型,类类型的签名部分内容。

小技巧:使用 类似于javap -classpath pathdir -s -p com.sample.JavaCode 的 javap -s -p 命令也可以帮助查看一些类中各种方法和成员变量的签名。

JNI相关命名解释

  • 函数名的格式遵循规则:Java_包名_类名_方法名
  • JNIEXPORT、JNICALL、JNIEnv和jobject 都是JNI标准中所定义的类型或者宏
  • JNIEnv * : 指向JNI环境的指针,可以通过JNIEnv * 访问JNI提供的接口方法
  • JNIEXPORT、JNICALL:是jni.h中所定义的宏。

注:JNIEnv * 可以简单的理解为Java和C/C++ 之间相互调用的桥梁,我们可以通过JNIEnv * 调用C/C++定义的方法,也可以在C/C++中通过JNIEnv * 来调用Java类中的方法。下面将会讲到C/C++中调用Java的方法,注意JNIEnv *的作用。

在C/C++中调用Java方法

首先说明一点,在Android开发过程中使用NDK主要是为了提高代码的安全性,有些游戏公司可能是为了方便利用已有的C/C++开源库来进行平台移植,其实在性能提升方面,NDK的作用并不是很明显。所以有时候一些在Java中实现起来非常简单的代码放在JNI里面做会显得吃力不讨好,所以干脆就直接在JNI中调用Java的方法,我们只把加密和验证的一些逻辑写到JNI层就行了。
在JNI中调用Java方法流程如下:

  1. 在Java中定义一个静态方法供JNI调用,注意要是静态的。
  2. 在JNI中利用env来调用Java中定义的静态方法
  3. 调用声明好的静态方法

可能流程说的比较抽象,用代码简单说明一下:

  1. 定义静态方法:

     //对应包名:com.mrljdx.jni.HelloJNI
     public static void helloJava() {    
         System.out.println("Hello JavaCode");
     }
    
  2. JNI声明静态方法:

     static void static_helloJava(JNIEnv *env){
           jclass clazz = env->FindClass("com/mrljdx/jni/HelloJNI");
           jmethodID mid = env->GetStaticMethodID(clazz, "helloJava", "()V");
           env->CallStaticVoidMethod(clazz, mid);
     }
    
  3. 调用声明好的静态方法:

     static_helloJava(env);
    

在AndroidStudio中NDK编程配置注意事项:

  1. 在项目的gradle.properties中添加ndk支持:

    android.useDeprecatedNdk=true
    
  2. 配置build.gradle看代码注释:

     defaultConfig {    
          minSdkVersion 9   
          targetSdkVersion 23   
          versionCode 1    
          versionName "1.0"    
         //配置ndk 支持   
         ndk {        
               //编译的so库名称 libsecurity.so
               moduleName "security"       
               //指定编译后的库支持的平台
               abiFilters "armeabi", "mips", "x86", "armeabi-v7a"  
               //用于指定应用应该使用哪个标准库,此处添加c++库支持   
               stl "stlport_static"    
           }
     }
    
  3. 在AndroidStudio中写JNI代码有一个比较爽的地方,就是Android.mk系统会在编译时自动帮你生成,你只需要配置build.gradle就行了。注意jni相关代码需要放在src/main/jni目录下。如果对gradle配置不了解可以参考我的博客:Gradle实战及学习建议

小结

在我们做产品的时候,应该考虑该用JNI&NDK的时候就用,一切出发点是基于用户的体验和数据安全,我觉得在以下几种情况下建议使用NDK:

  1. 重用现有的代码,比如C/C++的代码在Android中的重用。
  2. 数据安全,比如将Http的请求加密和解密算法放在NDK中去实现,这样可以提高应用的安全。
  3. 提升性能,由于Android设备制造商在手机中给每个应用分配了可用的最大RAM,有时候为了性能考虑,可以通过Native代码向系统来“借”一些内存,尽量少的使用系统分配给应用的内存。(参考Infoq:Android内存优化)

参考文章及书籍

END

由于本人能力有限,文中如有疏漏和错误之处还请斧正。开卷有益,多多交流~ O(∩_∩)O哈哈~
欢迎关注我的简书和个人博客 会不定期写一些在平时开发中遇到和解决问题和心得。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,378评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,356评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,702评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,259评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,263评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,036评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,349评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,979评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,469评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,938评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,059评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,703评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,257评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,262评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,485评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,501评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,792评论 2 345

推荐阅读更多精彩内容