Ubuntu下NDK编译环境搭建及在Android Studio中集成NDK
https://blog.csdn.net/zhuiqiuk/article/details/53420372
配置环境变量
将下载下来的文件进行解压,我这里解压到~/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中集成NDK
创建Android项目
在Android Studio中创建一个Android工程,我这里创建一个名为NDKJNIDemo的工程。
配置ndk.dir
在项目中的local.properties文件中添加如下代码来指定ndk的目录:
ndk.dir=~/android/android-ndk-r11b
配置gradle的ndk模块
在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" }
效果如下:
创建包含native方法的类
我这里创建了一个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保持一直,否则会报找不到库文件的异常。
创建C/C++源代码
生成头文件
进入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 <jni.h>
#include <string.h>
/* 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
创建jni目录
在module/src/main/下面新建jni目录,ndk会默认编译该目录下的源文件。目录结构如下图:
当然,你也可以自定义C/C++源代码目录,在module的build.gradle文件的android中添加如下代码:
sourceSets { main { jni.srcDirs 'src/main/jnisrc' } }
拷贝头文件到C/C++源代码目录并创建C源文件
将前面生成的头文件拷贝到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()。
运行效果
Gradle配置覆盖默认NDK编译
大家会发现几个问题:
-
为什么运行程序之后在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" }