AndroidStudio JNI详细教程+Gradle3.0以上JNI爬坑之旅

Demo下载地址:点击下载Demo

1.首先什么是JNI呢?

JNI——(Java Native Interface),他是java平台的特性,不是安卓系统提供的。他定义了一些JNI函数,来让开发者可以通过调用这些函数来实现java代码调用C/C++代码。

2.如何使用JNI呢?

我们先将写好的C/C++代码编译成对应平台的动态库(windows是.dll文件,linux是.so文件)。

下面我们来举个栗子:使用AndroidStudio来实现JNI

3.要实现JNI先下载NDK,那么NDK又是什么呢?(面试宝典来了,赶紧掏出小本本)

  • NDK是一系列工具的集合
  • NDK提供了一份稳定、功能有限的API头文件声明
  • NDK的发布,使“Java+C”的开发方式终于转正,成为官方支持的开发方式
  • NDK将使Android平台支持C开发的开端
    好,那接下来我们来下载NDK,有俩种方式:
  • Google官方下载NDK:点击下载
  • 通过SDKManager来下载NDK:


    image.png

4.下来我们new一个新工程:这个工程只包含一个MainActivity

image.png

5.我们来检查一下NDK下载好了没有,怎么检查呢?如下:

  • 检查SDK Location里面的NDK路径:


    image.png
  • 检查local.properties文件里面有没有NDK路径:


    image.png

6.下来我们要编写JNI接口啦,如下:

JNI接口需要用native关键字修饰,我们会看到方法名报红,没关系,我们继续


image.png

7.我们先build一下工程,检查myJNIUtils.java编译后有没有生成class文件,在这个位置下:

AndroidJNITest/app/build/intermediates/classes/debug/com/kissdream/androidjnitest/myJNIUtils.class

image.png

8.使用javah生成.h头文件,具体如下:

  • 打开Terminal,输入命令进入到debug目录下,命令如下:
    cd/Users/apple/Desktop/AndroidJNITest/app/build/intermediates/classes/debug
  • 然后使用javah+包名+文件路径来生成头文件,命令如下:
    javah com.kissdream.androidjnitest.myJNIUtils
    image.png
  • 检查头文件有没有生成:
    我们发现这个路径下多了个.h文件AndroidJNITest/app/build/intermediates/classes/debug/com/kissdream
    哈哈,没错这个就是我们要生成的头文件
    image.png

9.生成了.h文件还不行,只是声明了方法,我们还需要去实现它,那么如何去实现他呢,如下:

-我们在main下新建一个jni文件夹,如图:


image.png

image.png

.h文件内容如下:

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

#ifndef _Included_com_kissdream_androidjnitest_myJNIUtils
#define _Included_com_kissdream_androidjnitest_myJNIUtils
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_kissdream_androidjnitest_myJNIUtils
 * Method:    getName
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_kissdream_androidjnitest_myJNIUtils_getName
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

  • 把生成的.h文件拷贝到jni文件夹下
  • 在jni文件夹下,新建一个.c(c语言)或者.cpp(c++)的文件,来实现.h文件里声明的方法:
    把.h文件里面声明的方法拷贝到新建的c++文件里面,然后在文件里面引入.h文件:
    引入.h文件#include "com_kissdream_androidjnitest_myJNIUtils.h"
#include "com_kissdream_androidjnitest_myJNIUtils.h"
JNIEXPORT jstring JNICALL Java_com_kissdream_androidjnitest_myJNIUtils_getName
        (JNIEnv * env, jobject obj){
//如果是用C语言格式就用这种方式
//    return (*env)->NewStringUTF(env,"Kiss dream");
    //如果是用C语言格式就用这种方式
return env->NewStringUTF((char *)"Kiss dream");
}
image.png

到这里我们的方法就实现完毕了

10.方法我们实现了,但是我们如何调用呢,不要着急,Follow me:

  • 首先引入动态库:
public class myJNIUtils {
    static {
        //名字注意,需要跟你的build.gradle ndk节点下面的名字一样
        System.loadLibrary("NameProvider");
    }
    //JNI接口需要用native关键字修饰
    public native String getName();
}

NameProvider就是你要生成d的.so文件的文件名

  • 下面我们来调用它


    image.png

11.最重要的一步来了,生成so文件:

这个小编也不会,于是就去百度了下,得到结果:

  • 在根目录gradle.properties下面加上:
    android.useDeprecatedNdk=true意思就是允许使用低版本的NDK
  • 在module下面的build.gradle下面加上ndk节点如下图:
ndk {
        moduleName "NameProvider"
    }

NameProvider注意这个名字要跟你引入动态库的名字一样
需要这俩步就可以运行生成so文件了
然儿,并没有想象的那么顺利,报错了,我顿时心中飞过一万只草泥玛,上log:

Error:Execution failed for task ':app:compileDebugNdk'.
> Error: Flag android.useDeprecatedNdk is no longer supported and will be removed in the next version of Android Studio.  Please switch to a supported build system.
  Consider using CMake or ndk-build integration. For more information, go to:
   https://d.android.com/r/studio-ui/add-native-code.html#ndkCompile
   To get started, you can use the sample ndk-build script the Android
   plugin generated for you at:
   /Users/apple/Desktop/AndroidJNITest/app/build/intermediates/ndk/debug/Android.mk
  Alternatively, you can use the experimental plugin:
   https://developer.android.com/r/tools/experimental-plugin.html
  To continue using the deprecated NDK compile for another 60 days, set 
  android.deprecatedNdkCompileLease=1512283120054 in gradle.properties

百思不得其姐啊,百度的答案大家都是这样做啊,为什么人家可以我的就不行呢,我的代码和他的一模一样啊
为什么人家可以我的就不行呢,我的代码和他的一模一样啊这句话作为程序员的我们很熟悉!难到我要放弃吗?no no no,作为程序员的我怎么能轻言放弃呢!每个人都有这样的经历,蓝瘦过、香菇过,到最后我们都找到我们的错误
来我们仔细看下Log,大概意思就是说:

  • android.useDeprecatedNdk不再支持了

  • 让使用CMake or ndk-build

  • 然后还有链接
    考虑使用CMake或ndk构建集成。要了解更多信息,请访问:
    https://d.android.com/r/studio-ui/add-native-code.html#ndkCompile
    首先,您可以使用Android的ndk构建脚本示例插件为您生成:
    /Users/apple/Desktop/AndroidJNITest/app/build/intermediates/ndk/debug/Android.mk
    或者,你可以使用实验插件:
    https://developer.android.com/r/tools/experimental-plugin.html
    继续使用已弃用的NDK编译60天,设置
    在gradle.properties
    android.deprecatedNdkCompileLease = 1512283120054(这个测试不起作用)
    经过各种查资料,发现原来在gradle3.0以上以前这种方法不在支持
    学习过程就不详细描述了,直接上结果:

  • 先通过SDKManager下载:CMake和LLDB


    image.png
  • 在build.gradle的defaultConfig节点下加入:

// 使用Cmake工具
        externalNativeBuild {
            cmake {
                cppFlags ""
                //生成多个版本的so文件
                abiFilters 'arm64-v8a','armeabi-v7a','x86','x86_64'
            }
        }
  • 在build.gradle的android节点下加入:
// 配置CMakeLists.txt路径
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"   // 设置所要编写的c源码位置,以及编译后so文件的名字
        }
    }
image.png
  • 添加CMakeLists.txt文件到build.gradle文件同级目录下,具体内容如下:
# For more information about using CMake with Android Studio, read the
# documentation: https://d.android.com/studio/projects/add-native-code.html

# Sets the minimum version of CMake required to build the native library.
#CMakeLists.txt
cmake_minimum_required(VERSION 3.4.1)

# Creates and names a library, sets it as either STATIC
# or SHARED, and provides the relative paths to its source code.
# You can define multiple libraries, and CMake builds them for you.
# Gradle automatically packages shared libraries with your APK.

add_library( # Sets the name of the library.
            # 设置so文件名称.
             NameProvider

             # Sets the library as a shared library.
             SHARED
             # 设置这个so文件为共享.

             # Provides a relative path to your source file(s).
             # 设置这个so文件为共享.
             src/main/jni/getName.cpp)

# Searches for a specified prebuilt library and stores the path as a
# variable. Because CMake includes system libraries in the search path by
# default, you only need to specify the name of the public NDK library
# you want to add. CMake verifies that the library exists before
# completing its build.

find_library( # Sets the name of the path variable.
              log-lib

              # Specifies the name of the NDK library that
              # you want CMake to locate.
              log )

# Specifies libraries CMake should link to your target library. You
# can link multiple libraries, such as libraries you define in this
# build script, prebuilt third-party libraries, or system libraries.

target_link_libraries( # Specifies the target library.
                       # 制定目标库.
                       NameProvider

                       # Links the target library to the log library
                       # included in the NDK.
                       ${log-lib} )

image.png

至此,我们所有的流程都做完了,下面来检查一下我们的成果,见证奇迹的时候到了:
image.png

可以看到我们已经成功生成so文件,再来上个效果图:
image.png

下载地址:点击下载Demo

当然,实现JNI有更简单的方法,可以一键集成,省去了上面的好多步骤,但是作为一名开发者,我们要知道开发工具为我们做了什么……不要做一名只会吃技术快餐的程序员,要了解背后的原理,只是会使用,不了解原理的程序员不是一名好厨师……

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

推荐阅读更多精彩内容