一、安装与配置
首先我们在Android Studio下新建一个安卓项目。然后打开Project Structure界面,如下:
在SDK Location目录下,有SDK和NDK的路径,而这里我们暂时还未下载配置过NDK,故我们需要点击Download Android NDK来进行下载(Android Studio还是很强大的,相比Eclipse能省不少事)。这里Android Studio会下载最新版本的NDK进行安装,默认会下载保存在SDK的路径下。我们在上图中还能看到有一段介绍文字,说SDK以及NDK的路径配置会保存在local.properties文件内,安装完成后我们刷新Project,进local.properties文件查看也能看到SDK与NDK的路径。
NDK下载配置完成之后,需要在gradle.properties文件中加上一行:
android.useDeprecatedNdk=true
注意:如果报一下错误。
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:
E:\SwimmingSpace\ndktest\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=1570668052257 in gradle.properties
在gradle.properties文件里把android.useDeprecatedNdk去掉换成android.deprecatedNdkCompileLease=1570668052257就行了
接下来,我们借助强大的Android Studio的插件功能,在External Tools下配置两个非常有用的插件。进入Settings–>Tools–>ExternalTools,点击+号增加。
javah -jni命令,是根据java文件生成.h头文件的,会自动根据java文件中的类名(包含包名)与方法名生成对应的C/C++里面的方法名。下面是参数配置及其含义:
1. Program: $JDKPath$\bin\javah.exe 这里配置的是JDK目录下的javah.exe的路径。
2. Parametes: -classpath . -jni -d $ModuleFileDir$/src/main/jni $FileClass$ 这里$FileClass$指的是要执行操作的类名(即我们操作的文件),$ModuleFileDir$/src/main/jni表示生成的文件保存在这个module目录的src/main/jni目录下。
3. Working: $ModuleFileDir$\src\main\java module目录下的src\main\java目录(不是很理解)。
使用方式:选中java文件—>右键—>External Tools—>javah-jni,将生成jni文件夹以及文件夹下的 包名.类名的.h头文件 (名字过长,我们可以自己重命名)。
ndk -build命令,是根据C/C++文件生成so文件的。下面是参数配置及其含义:
1. Program: F:\apk\sdk\ndk-bundle\ndk-build.cmd 这里配置的是ndk下的ndk-build.cmd的路径(根据实际情况填写)。
2. Working: $ModuleFileDir$\src\main\
在build.gradle中的android添加
sourceSets {
main() {
jniLibs.srcDirs = ['src/main/libs']
}
}
要不为弹出ANR运行错误提示找不到.so库。
二、简单实例
1、创建一个访问本地C/C++方法的java类
package cyh.com.ndk_demo;
public class JniTest {
static {
System.loadLibrary("JniTest");
}
public static native String get();
}
注意JniTest这个Library名字,之后在Android.mk中还会需要用到,要保持一致。该类提供了一个static的native方法,该方法将用来返回一个字符串。然后对该文件执行javah -jni操作,选中java文件—>右键—>External Tools—>javah-jni,生成对应的.h头文件。
如图,已经根据我们的java类生成了对应的.h文件,文件名为包名_类名.h,里面只有一个方法,返回值为String(jstring),方法名为Java_类的包名_类名_方法名(包名中的分级不是用.而是_),前面两个参数是C++里面必须有的(JNIEnv代表指向JVM的指针,jclass是调用该方法的java对象),第三个就是我们java类的方法里面的参数Object。注意,这是java函数与C++函数对应的静态注册方法,即通过特定的规则来写,此处方法名可以随意起名字,然后还可以用动态注册的方式关联两个方法(显然,静态注册要简单一些)。
2、然后我们新建一个C文件,取名为test.c,写上需要include的文件,从.h文件中复制方法过来(方法名、参数类型、返回值等必须一致!血与泪的教训)。
至此,.h文件和c文件均已完成,接下来还需要在这个jni目录下增加两个文件,Android.mk和Application.mk。
Android.mk,注意LOCAL_MODULE的值与之前的名字相对应,LOCAL_SRC_FILES的值写c++文件的名字,这两个值成对设置,可设置多组。(:=是赋值的意思,$是引用某变量的值。)
- LOCAL_PATH := $(call my-dir) // 设置当前的编译目录(Android.mk所在的目录)
- include $(CLEAR_VARS) // 清除LOCAL_XX变量(LOCAL_PATH除外)
- LOCAL_MODULE := JNI_ANDROID_TEST // 指定当前编译模块的名称
- LOCAL_SRC_FILES := jnitest.cpp // 编译模块需要的源文件
- include $(BUILD_SHARED_LIBRARY) // 指定编译出的库类型,BUILD_SHARED_LIBRARY:动态库;BUILD_STATIC_LIBRARY:静态库, BUILD_EXECUTEABLE指:可执行文件
Application.mk,APP_ABI有四种类型(默认armeabi),armeabi、armeabi-v7a、x86、mips,设置时以空格隔开,all表示所有。该文件中有个可选配置的APP_MODULES,类似于上面Android.mk文件中的LOCAL_MODULE,以空格隔开,且会覆盖掉Android.mk文件中的LOCAL_MODULE设置(比如Android.mk文件中的写了两个jni库的配置,LOCAL_MODULE := JNI1、LOCAL_MODULE := JNI2,而Application.mk中设置的APP_MODULES := JNI1,则只能生成JNI1的so文件,要生成JNI2的so文件的时候会报错,除非写成APP_MODULES := JNI1 JNI2,这里我们直接省略默认使用Android.mk中的)。
APP_ABI := all
接下来我们需要对C文件执行ndk-build操作,使用方式:选中C/C++文件—>右键—>ExternalTools—>ndk-build,生成相应的so文件。
如图,在main/libs目录下生成了多个so文件,名字为lib+我们指定的库名,同时还生成了obj文件夹。
3、在MainActivity中调用C方法即可。
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//打印信息
Log.e("Message", JniTest.get());
}
若更改c文件名称或者内容,出现make: *** No rule to make target `jni\test.c', needed by `obj/local/arm64-v8a/objs/JniMethod/test.o'. Stop.错误!
可以手动删除libs和obj 文件夹,即可重新生成.so库。
以上内容大部分来自网络,注意参考:https://blog.csdn.net/xiaoyu_93/article/details/52870395