Android JNI/NDK开发之基本姿势<一>

开发环境信息

列举下本篇文章编写的Demo基本信息
操作系统 Windows 10 家庭中文版
开发工具 Android Studio 2.1
SDK new
NDK new

扫盲之SDK、JDK、NDK的区别

SDK 软件开发工具包;英语全称:Software Development Kit
JDK Java语言的软件开发工具包;英语全称:Java Development Kit
NDK 原生软件开发工具包;英语全称:Native Development Kit;被Google称为NDK

由此可见,其实不管什么XDK,都可以叫SDK,可能为了有很好的区分,便有了JDKNDK,所以我们有的时候常说的SDK并不是特指安卓开发工具包,而只是我们都是同行,交流的时候都知道指的是什么,其实你们会发现,我们常常接三方平台的时候,那些工具包也是叫SDK,但可能我们在交流的时候就会加个前缀,比如:微信分享SDK、支付宝SDK、xxSDK。


学习目标

1.配置NDK环境并学会合理利用Android Studio工具进行NDK的编译
2.点击某个按钮显示由native方法返回的一段文本信息;java > native
3.点击某个按钮调用某个native方法,在由此native方法调用java方法;java > native > java

创建工程并配置NDK路径

快速利用Android Studio创建一个简单的Hello Word工程,相信这个大家都已经熟门熟路了,如果你还不知道使用Android Studio,我只能说你太不open了。

配置工程NDK有两种方法,和配置SDK一模一样,这里就说说两个SDK [1] 的配置方法吧

1.直接在local.properties文件中手动配置

ndk.dir=E:\Android\sdk\ndk-bundle //NDK路径
sdk.dir=E:\Android\sdk //SDK路径

2.Open Module Settings

选中工程名,鼠标右键>Open Module Settings或直接按下F4功能键


sdk.dir

编写带有Native方法的类

1.创建JniDemoClass文件并创建一个native方法public native String getHelloWordText(),用来获取Hello Word文本

public class JniDemo {

    public native String getHelloWordText();
    
}

编译含有Native方法的类

javac JniDemo.java

得到JniDemo.class文件后继续用javah命令编译JniDemo.class,格式:javah package name + class name,示例:

javah com.jay.ndkdemo.JniDemo

其中com.jay.ndkdemo是此类所在的包名,编译成功会在当前目录生成一个*.h文件,这种文件类是C或C++所支持的头文件类型。内容如下:

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

#ifndef _Included_com_jay_ndkdemo_JniDemo
#define _Included_com_jay_ndkdemo_JniDemo
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_jay_ndkdemo_JniDemo
 * Method:    getHelloWordText
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_jay_ndkdemo_JniDemo_getHelloWordText
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

本文示例生成的名称叫:com_jay_ndkdemo_JniDemo.h,很明显,以包名+类名生成一个文件名,我们在工程中创建一个文件夹jni,此目录与工程中的java目录同级,并把生成的*.h文件放置到jni文件夹中。

jni


编写C/C++代码并实现*.h中声明的方法

创建*.c<C>*.cpp<C++>文件,编写Code,本文编写的是*.c文件,也就是采用C语法来实现

#include <com_jay_ndkdemo_JniDemo.h>

/*
 * Class:     com_jay_ndkdemo_JniDemo
 * Method:    getHelloWordText
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_jay_ndkdemo_JniDemo_getHelloWordText
  (JNIEnv * env, jobject obj)
{
 return (*env)->NewStringUTF(env,"Hello Word From Jni");
}

简单说下编写方法:
1.include 下我们前面生成的*.h文件
2.实现*.h中未实现的方法,注意方法名要与*.h中保持一致

到这里,我们的工作已经完成了90%,剩下的只是配置与调用了


NDK编译

这个时候我们就要发挥Android Studio工具的方便性了,怎么利用NDK编译了?前面我们已经配置好了NDK路径,那么直接利用Android Studio的菜单build > Rebuild Project,执行后发现失败

ndk-build-error

错误信息:

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:compileDebugNdk'.
> Error: NDK integration is deprecated in the current plugin.  Consider trying the new experimental plugin.  For details, see http://tools.android.com/tech-docs/new-build-system/gradle-experimental.  Set "android.useDeprecatedNdk=true" in gradle.properties to continue using the current NDK integration.

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.

其实这个错误信息中已经告诉我们怎么解决

Set "android.useDeprecatedNdk=true" in gradle.properties to continue using the current NDK integration

叫我们在gradle.properties文件中输入android.useDeprecatedNdk=true,输入后我们再次编译,这次编译成功,但发现一个警告:

ndk-build-warning

警告信息:

Warning: Native C/C++ source code is found, but it seems that NDK option is not configured.  Note that if you have an Android.mk, it is not used for compilation.  The recommended workaround is to remove the default jni source code directory by adding: 
 android {
    sourceSets {
        main {
            jni.srcDirs = []
        }
    }
}
to build.gradle, manually compile the code with ndk-build, and then place the resulting shared object in src/main/jniLibs.

大概意思就是我们缺少一个文件:Android.mk,但人家给了我们推荐的方法,那就是在对应module工程中的build.gradle文件中添加如下代码:

sourceSets {
    main {
        jni.srcDirs = []
    }
}

添加后我们再次编译,这次编译成功并没错误也没警告,终于NDK编译通过了,我们查看编译结果:\NdkDemo\app\build\intermediates\ndk

ndk-build-result

我们可以看到,生成了一系列的*.so文件,是不是感觉很熟悉了?但我们发现*.so文件名叫libapp.so,这个文件名是怎么来的了?可以更改吗?答案是肯定的。

先说说默认文件名的生成格式:lib + module name.so

更改默认文件名名称:

android {
    ......
    defaultConfig {
        ......
        ndk {
            moduleName 'jnidemo'//自定义名称
        }
    }
}

好,我们再次编译,编译完成后我们查看编译路径下,闷B了吧,没看到ndk目录了,有人就会说了,你这个坑货,骗人的,友谊的小船说翻就翻。

sourceSets {
    main {
//      jni.srcDirs=[]
      jniLibs.srcDir 'src/main/jni_src'//告知jni源码目录
    }
}

还记得这个配置不,对,就是我们之前第一次编译的时候解决一个警告按照警告的推荐写的配置代码,只要改成和上面一样,编译后就又可以看到编译目录下的ndk文件夹了,查看编译后的*.so文件,发现文件名已经改了,并且生成的格式和我之前说的一样。

为什么我们按照推荐方法会有问题了?
1.可能是bug
2.我觉得应该是我们既然了默认的一些参数,当然就要对其它参数做出相应的修改


好了,看完这篇文章,我们基本实现了我们的学习目标的第一点,后面两点请看后续系列文章


  1. 此处SDK包含NDK与安卓SDK

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

推荐阅读更多精彩内容