1.下载并配置NDK
步骤1:下载NDK
- 下载NDK Android官网下载地址
- 解压。将解压路径设置为:Android Studio的SDK目录里,并命名为ndk-bundle。(Android Studio会自动检查该路径进行配置,从而省去了收到配置ndk的工作)
步骤2: 配置NDK环境变量
- 在系统环境变量里面创建NDK_HOME
- 将NDK_HOME追加到Path环境变量下;%NDK_HOME%
- 添加完毕后打开cmd,输入ndk-build -h,出现如下内容则表示ndk环境配置成功
2.创建一个Android项目,并声明所需的native方法
package com.example.myndkdemo1;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;
public class MainActivity extends AppCompatActivity
{
static
{
System.loadLibrary("jni-test");
}
@Override
protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
TextView mainTv = (TextView) findViewById(R.id.main_text);
mainTv.setText(get());
set("hello world from JniTestApp");
}
public native String get();
public native void set(String str);
}
3.实现Android项目中所声明的native方法
在main下创建一个名为jni的目录,然后在jni目录下创建3个文件:test.cpp、Android.mk和Application.mk,它们的实现如下所示。
test.cpp:
# include <jni.h>
# include <stdio.h>
# include <android/log.h>
#define TAG "myhello-jni-test" // 这个是自定义的LOG的标识
#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG,TAG,__VA_ARGS__) // 定义LOGD类型
#ifdef __cplusplus
extern "C"
{
#endif
jstring Java_com_example_myndkdemo1_MainActivity_get(JNIEnv *env, jobject thiz)
{
LOGD("来自C++实现的get方法");
return env -> NewStringUTF("Hello from JNI in libjni-test.so!");
}
void Java_com_example_myndkdemo1_MainActivity_set(JNIEnv *env, jobject thiz, jstring string)
{
LOGD("来自C++实现的set方法");
char* str = (char*)env -> GetStringUTFChars(string,NULL);
LOGD("%s\n",str);
env -> ReleaseStringUTFChars(string, str);
}
#ifdef __cplusplus
}
#endif
首先函数名的格式遵循如下规则:Java_包名_类名_方法名。比如MAinActivity中的set方法,到这里就变成了Java_com_example_myndkdemo1_MainActivity_set(JNIEnv *env, jobject thiz, jstring string),其中com_example_myndkdemo1是包名,MainActivity是类名。
JNIEnv、jobject 和jstring是JNI标准中所定义的类型或者宏,他们的含义如下:
- JNIEnv*:表示一个指向JNI环境的指针,可以通过它来访问JNI提供的接口方法;
- jobject:表示Java对象中的this;
- jstring:表示Java中的String。
下面的宏定义是必须的,它指定extern “C”内部的函数采用C语言的命名风格来编译。否则当JNI采用C++来实现时,由于C和C++编译过程中对函数的命名风格不同,这将导致JNI在链接时无法根据函数名查找到具体的函数,那么JNI调用就无法完成。
#ifdef __cplusplus
extern "C"
{
#endif
如果C++想使用Android Log API输出日志,需在cpp文件中引入类库,并定义宏,便可使用Android Log API输出日志了。
# include <android/log.h>
#define TAG "myhello-jni-test" // 这个是自定义的LOG的标识
#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG,TAG,__VA_ARGS__) // 定义LOGD类型
Android.mk
#设置工作目录,而my-dir则会返回Android.mk文件所在的目录
LOCAL_PATH := $(call my-dir)
#清除几乎所有以LOCAL_PATH开头的变量(不包括LOCAL_PATH)
include $(CLEAR_VARS)
#表示模块的名称
LOCAL_MODULE := jni-test
#表示需要参与编译的源文件
LOCAL_SRC_FILES := test.cpp
#引入一个和日志相关的库文件
LOCAL_LDLIBS :=-llog
#指定生成的静态库或者共享库在运行时依赖的共享库模块列表
include $(BUILD_SHARED_LIBRARY)
Application.mk
#表示CPU的架构平台的类型
APP_ABI := armeabi x86
4.通过ndk-build命令编译产生so库
这个时候NDK会创建一个和jni目录平级的目录libs,libs下面存放的就是so库的目录。需要注意的是,ndk-build命令会默认指定jni目录作为本地源码的目录,如果源码存放的目录名不是jni,那么ndk-build则无法成功编译。
然后在app/src/main中创建一个名为jniLibs的目录,将生成的so库复制到jniLibs目录中,删掉刚刚生成的libs、obj和jni文件夹,然后clean一下编译运行即可。运行效果如下图,则说明从Android中调用so库中的方法已经成功了。
在上面的步骤中,需要将ndk编译的so库放置到jniLibs目录下,因为这个是Android Studio所识别的默认目录,如果想使用其他目录,可以按照如下方式修改app下的build.gradle文件,其中jniLibs.srcDir选项指定了新的存放so库的目录是jni_libs。
android {
...
sourceSets.main {
jniLibs.srcDirs 'src/main/jni_libs'
}
}