Android studio 下JNI编程实例并生成so库的实现代码

最近需要使用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