首先需要下载NDK编译工具,目前官方最新的NDK版本是r11c,为了保证稳定性,我下的是r11b。
能的可以从谷歌官网下载,地址为: https://developer.android.com/ndk/downloads/index.html
不能的也可以从下面网站下载,该网站提供了Android开发各种工具的下载: http://www.androiddevtools.cn/index.html
将下载下来的文件进行解压,我这里解压到~/android/android-ndk-r11b。
然后在~/.profile文件中加入如下内容,将NDK目录加入到PATH中:
#set ndk environment
export NDK_HOME=~/android/android-ndk-r11b
export PATH=$PATH:$NDK_HOME
最后执行“source ~/.profile”使之生效。
配置好环境变量之后,需要验证一下是否搭建成功,在命令行下输入ndk-build,有如下提示则表示搭建成功了。
在Android Studio中创建一个Android工程,我这里创建一个名为NDKJNIDemo的工程。
在项目中的local.properties文件中添加如下代码来指定ndk的目录:
ndk.dir=~/android/android-ndk-r11b
在module的build.gradle文件的android.defaultConfig添加如下代码:
ndk {
moduleName "NDKJNIDemo"
}
这里配置的moduleName就是编译生成so库的名字,比如这里生成的so库名字为“libNDKJNIDemo.so”。
ndk还可以配置更多选项,如下:
ndk {
moduleName "NDKJNIDemo"
cFlags "-DANDROID_NDK -D_DEBUG DNULL=0" // Define some macros
ldLibs "EGL", "GLESv3", "dl", "log" // Link with these libraries!
stl "stlport_shared" // Use shared stlport library
abiFilters "armeabi", "armeabi-v7a", "x86" // Set the platform
}
Android Studio默认会编译所有平台下的so库。
如果你只想编译指定平台的so库,可以加入如下配置,在module的build.gradle文件的android中加入如下代码:
ndk {
moduleName "NDKJNIDemo"
abiFilters "armeabi", "armeabi-v7a", "x86"
}
效果如下:
我这里创建了一个JniUtils类,并且创建了一个名为getStringFromC()的nativie方法,该方法作用就是简单的从JNI层返回一个字符串给Java层,代码如下:
package com.liuling.ndkjnidemo;
/**
* Created by liuling on 16-5-16.
*/
public class JniUtils {
static {
System.loadLibrary("NDKJNIDemo");//与build.gradle里面设置的so名字,必须一致
}
public static native String getStringFromC();
}
这里得注意loadLibrary加载的so库的名字必须和上面第3步配置的moduleName保持一直,否则会报找不到库文件的异常。
进入module/build/intermediates/classes/debug目录下,在命令行下使用javah生成头文件,我这里是这样的:
cd app/build/intermediates/classes/debug
javah -jni com.liuling.ndkjnidemo.JniUtils
完了之后会在module/build/intermediates/classes/debug目录下生成相应的头文件,我这里生成的是com_liuling_ndkjnidemo_JniUtils.h,内容如下:
/* DO NOT EDIT THIS FILE - it is machine generated */
#include
#include
/* Header for class com_liuling_ndkjnidemo_JniUtils */
#ifndef _Included_com_liuling_ndkjnidemo_JniUtils
#define _Included_com_liuling_ndkjnidemo_JniUtils
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_liuling_ndkjnidemo_JniUtils
* Method: getStringFormC
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_liuling_ndkjnidemo_JniUtils_getStringFromC
(JNIEnv *, jclass);
#ifdef __cplusplus
}
#endif
#endif
在module/src/main/下面新建jni目录,ndk会默认编译该目录下的源文件。目录结构如下图:
当然,你也可以自定义C/C++源代码目录,在module的build.gradle文件的android中添加如下代码:
sourceSets {
main {
jni.srcDirs 'src/main/jnisrc'
}
}
将前面生成的头文件拷贝到C/C++源代码目录,并创建相应的C代码文件,我这里创建了com_liuling_ndkjnidemo_JniUtils.c,内容如下:
#include "com_liuling_ndkjnidemo_JniUtils.h"
/*
* Class: com_liuling_ndkjnidemo_JniUtils
* Method: getStringFormC
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_liuling_ndkjnidemo_JniUtils_getStringFromC
(JNIEnv *env, jclass obj) {
return (jstring)(*env)-> NewStringUTF(env, "I am string from jni-jnisrc");
}
Java_com_liuling_ndkjnidemo_JniUtils_getStringFromC方法就是对应JniUtils里的native方法getStringFromC()。
大家会发现几个问题:
为什么运行程序之后在main下面没找到so库呢?
为什么编译时不需要Android.mk文件呢?
默认情况下ndk将生成的so库放到了build下面去了,同时也会使用一个默认的Android.mk文件进行编译,如下图:
那我们能否覆盖默认的设置呢?答案时肯定的!
首先在项目gradle文件的android{}中添加如下代码:
sourceSets {
main {
jni.srcDirs = [] //屏蔽gradle的jni生成过程
jniLibs.srcDir 'src/main/libs' //指定引用so库的目录
}
}
然后在gradle文件最底部添加一个ndk编译task:
task ndkBuild(type: Exec) {
commandLine 'ndk-build', '-C', file('src/main/jni').absolutePath
}
tasks.withType(JavaCompile) {
compileTask -> compileTask.dependsOn ndkBuild
}
注意:使用上述命令必须确定ndk的环境变量配置好了,也就是确定ndk的目录加到PATH中去了,否则该任务会执行失败。
最后自己在jni目录下面建立Android.mk和Application.mk文件,直接点击AS上的运行就会先执行NDK编译的过程。
Android.mk:
LOCAL_PATH := $(call my-dir)
local_c_includes := \
$(NDK_PROJECT_PATH) \
include $(CLEAR_VARS)
# so库名字
LOCAL_MODULE := NDKJNIDemo
LOCAL_SRC_FILES := com_liuling_ndkjnidemo_JniUtils.c
# 添加log模块
LOCAL_LDLIBS := -lm -llog
include $(BUILD_SHARED_LIBRARY)
Application.mk:
APP_ABI := armeabi x86
#使NDK支持string
APP_STL := stlport_shared
APP_STL := stlport_static
可以看到,默认情况下可以在gradle中的ndk中配置以上这些信息:
ndk {
moduleName "NDKJNIDemo"
ldLibs "log"
stl "stlport_shared"
abiFilters "armeabi", "x86"
}