最近需要使用JNI编程,学了下JNI,并且在Android Studio下实现了一个小demo。这期间有一些坑,还好都解决了,想分享出来,希望大家少走弯路。本文中采用的平台是Windows,NDK环境已经搭建好,这方面资料很多,大家可以自行百度。
本文分为两个部分:
1.如何通过编写Jni实现native方法的调用。
2.怎样生成.so动态库提供给第三方使用。
以下是正文:
一,编写jni文件,实现本地方法
1,建立一个新工程,只有一个MainActivity,里面加载库文件并且调用若干本地方法,然后通过Android Studio里的build-makeProject生成class文件。
public class MainActivity extends Activity { private final String TAG = "JNITEST" @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); String s=returnString(); Log.d(TAG,s); int a=1000; Log.d(TAG,sayhello(a)); } //加载jni static { System.loadLibrary("nativeTest"); } //声明native方法 private native int sayhello(int t); private native String returnString(); }
2,生成.h头文件,里面有Android工程里本地方法的声明。这个文件可以自己写,但是推荐用javah自动生成。生成方法为:在控制台或者Android studio自带的控制台使用javah命令将上一步make之后生成的class文件生成.h头文件,这里在用javah的时候有可能会出问题,比如我第一次就出现了找不到app.activity ,即找不到类文件,这种问题一般是没有理解javah的用法造成的。我当时采用以下两种方法:
方法1: cd到 E:\shijue\JniHello\app\src\main
然后输入 javah -d jni -classpath I:\Andriod\AndroidSDK\platforms\android-15\android.jar;
E:\shijue\JniHello\app\build\intermediates\classes\debug com.example.machenike_pc.jnihello.MainActivity
说明:javah是生成头文件的命令,深绿色为生成文件夹jni,紫红色为android.jar所在的位置,浅绿色为class文件的路径+类全名(路径最后一个文件夹是debug之后空格+类全名)
(这里补充下-classpath的含义:javah操作是针对类文件,-bootclasspath和-classpath就是指定在哪里进行类文件搜索。JDK搜索类文件先后顺序如下:Bootstrap classes,User classes。Bootstrap默认的是JDK自带的jar或zip文件,它包括jre\lib下rt.jar等文件,JDK首先搜索这些文件.可以通过-bootclasspath来设置它。文件之间用分号";"进行分割。User classes搜索顺序为当前目录、环境变量 CLASSPATH、-classpath。它们用于告知JDK搜索类文件根目录名、jar文档名、zip文档名,用分号";"进行分隔。)
方法2: cd到E:\shijue\JniHello\app\build\intermediates\classes\debug目录下,直接javah -d jni com.example.machnike_pc.jnihello.MainActivity 即可
3,在生成的jni目录下写一个c或者c++文件,文件名随意,实现本地方法 ,之后需要在该路径下再加一个空的cpp或c文件(估计是软件的bug,不加的话很可能出ndk错误),比如我加了个util.cpp的文件,里面什么都不写。
下面是我的c++代码
#include<jni.h> #include<stdio.h> #include<com_example_machenike_pc_jnitest2_MainActivity.h> #ifdef __cplusplus extern "C" { #endif JNIEXPORT jint JNICALL Java_com_example_machenike_1pc_jnitest2_MainActivity_sayhello (JNIEnv *, jobject, jint); JNIEXPORT jstring JNICALL Java_com_example_machenike_1pc_jnitest2_MainActivity_returnString (JNIEnv *, jobject); #ifdef __cplusplus } #endif JNIEXPORT jint JNICALL Java_com_example_machenike_1pc_jnitest2_MainActivity_sayhello (JNIEnv * env, jobject jobj, jint jnumber) { int modify=jnumber+1; return modify; } JNIEXPORT jstring JNICALL Java_com_example_machenike_1pc_jnitest2_MainActivity_returnString (JNIEnv *env, jobject jobj) { return env->NewStringUTF("I'm comes from to Native Function!"); }
4,如果ndk版本不是最新的,需要在gradle.properties文件下加入:
android.useDeprecatedNdk=true
5,配置ndk路径,这里也可以在AS的设置里面配置。我采用的方法是在local.properties文件最后一行加入:
ndk.dir=I\:\\Andriod\\NDK\\android-ndk-r10b
6,build.gradle(app下):文件下加入:(defaultconfig里面)
ndk{
moduleName "nativeTest"
}
此时运行程序已经可以实现本地方法了,之后可以再生成so库文件,方便使用。
二,生成.so动态库
(这里说一下,貌似Android studio已经写好了.mk文件,上面的步骤完成后,直接rebuild一下就自动生成为了.so动态库,下面的方法也能生成,可以看一下,很有用)
1,在jni文件夹下新建Android.mk文件,写入以下内容:
LOCAL_PATH := $(call my-dir) //固定写法,把路径赋给LOCAL_PATH变量
include $(CLEAR_VARS) //清除其他LOCAL变量
LOCAL_MODULE := nativeTest //这个模块的名字,最后生成的.so的名字就是它,要跟java里面的loadLibray的名字一样。
LOCAL_SRC_FILES := nativeTest.cpp\ //这里是要编译的文件,\ 符号是换行
util.cpp
include $(BUILD_SHARED_LIBRARY) //SHARED_LIBRARY就是动态库,即.so文件
这里的写法是最简单的一个例子,用的时候把注释去掉。每一行都是很关键,不能省略。至于makefile怎么编写内容比较多,此处不赘述。
2,在工程根目录下新建application.make文件,写入以下内容:
APP_PROJECT_PATH := $(call my-dir)
APP_MODULES := nativeTest
3,在命令行下,cd到jni目录(就是之前javah -d jni生成的那个文件夹)下,输入指令: ndk-build,等一会即可生成.so文件。位于lib目录下,将其放到app/src/main/jniLibs目录下就能用了。
FAQ:
1,生成的so文件在使用时需要注意:包名不能变,拿上文举例,本地方法位于com_example_machenike_pc_jnitest2_MainActivity这个类下,如果在别的地方用,需要完整的建立这个包名和类。
2,c和cpp文件均可以用来写jni,写法上略有不同。
3,需要注意java里面成员方法和静态方法通过javah生成的头文件略有不同,一个参数是jclass,另一个是jobject。
4,不用javah生成头文件也行,推荐第一次写的时候用javah生成,后面修改的时候(比如参数改变)可以直接在c文件里手动修改。
补充:
SourcePath: D:\work\androidstudio\VisualRecognition\app\src\main\java (绝对路径)
TargetPath: D:\work\androidstudio\VisualRecognition\visual\src\main\jni (绝对路径)
TargetClassName: com.yf.visualrecognition.UnityPlayerActivity (你的包名+类名)
格式: javah -d ${SourceFile} -classpath ${TargetPath} ${TargetClassName}
生成.h文件:javah -d E:\AndroidProject\GitHubProject\OpenCV\OpenCV\app\src\main\jni -classpath E:\AndroidProject\GitHubProject\OpenCV\OpenCV\app\src\main\java com.cosco.opencv.OpenCVHelper