最近需要使用JNI编程,学了下JNI,并且在Android Studio下实现了一个小demo。这期间有一些坑,还好都解决了,想分享出来,希望大家少走弯路。本文中采用的平台是Windows,NDK环境已经搭建好,这方面资料很多,大家可以自行百度。
本文分为两个部分:
1.如何通过编写Jni实现native方法的调用。
2.怎样生成.so动态库提供给第三方使用。
以下是正文:
一,编写jni文件,实现本地方法
1,建立一个新工程,只有一个MainActivity,里面加载库文件并且调用若干本地方法,然后通过Android Studio里的build-makeProject生成class文件。
代码语言:javascript复制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:shijueJniHelloappsrcmain
然后输入 javah -d jni -classpath I:AndriodAndroidSDKplatformsandroid-15android.jar; E:shijueJniHelloappbuildintermediatesclassesdebug 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文件,它包括jrelib下rt.jar等文件,JDK首先搜索这些文件.可以通过-bootclasspath来设置它。文件之间用分号”;”进行分割。User classes搜索顺序为当前目录、环境变量 CLASSPATH、-classpath。它们用于告知JDK搜索类文件根目录名、jar文档名、zip文档名,用分号”;”进行分隔。)
方法2: cd到E:shijueJniHelloappbuildintermediatesclassesdebug目录下,直接javah -d jni com.example.machnike_pc.jnihello.MainActivity 即可
3,在生成的jni目录下写一个c或者c 文件,文件名随意,实现本地方法 ,之后需要在该路径下再加一个空的cpp或c文件(估计是软件的bug,不加的话很可能出ndk错误),比如我加了个util.cpp的文件,里面什么都不写。
下面是我的c 代码
代码语言:javascript复制#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:workandroidstudioVisualRecognitionappsrcmainjava (绝对路径)
TargetPath: D:workandroidstudioVisualRecognitionvisualsrcmainjni (绝对路径)
TargetClassName: com.yf.visualrecognition.UnityPlayerActivity (你的包名 类名)
格式: javah -d {SourceFile} -classpath {TargetPath}
生成.h文件:javah -d E:AndroidProjectGitHubProjectOpenCVOpenCVappsrcmainjni -classpath E:AndroidProjectGitHubProjectOpenCVOpenCVappsrcmainjava com.cosco.opencv.OpenCVHelper