使用Android Studio进行JNI开发 － Mac篇

对于入门级Android菜鸟的我来说，从配置到开发JNI是一个煎熬的过程，但还是取得了最终的成功。这里主要是整个过程进行了整理，让其他跟我一样受煎熬的人尽早跳出来，继续向光明迈进…

环境配置

开发JNI项目前提是需要有NDK（Native Development Kit）的支持。因此，在开发前需要先安装和配置NDK。步骤如下：

1. 点击菜单”Tools” -> “Android” -> “SDK Manager”打开SDK管理器。

2. 选中右边面板的”SDK Tools”页签，勾选”NDK”一栏，然后点击”Apply”来下载并安装NDK（如下图）。

第一个JNI例子

1. 新建Android项目

点击菜单“File”－“New”－“New Project…”打开新建项目界面, 输入项目名称：

选择支持的平台及最低支持的系统版本

选择项目模版Basic Activity

设置Activity的命名

至此，创建项目完成。

2. 设置项目支持JNI

打开gradle.properties文件，在该文件下添加：

android.useDeprecatedNdk=true

打开local.properties文件，在该文件下添加：

ndk.dir=NDK的路径

再打开模块的build.gradle文件，在android/defaultConfig下面添加ndk节点，如下所示：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        applicationId "vimfung.cn.jnisample"
        minSdkVersion 15
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"

        ndk {
            moduleName "JNISample"
            stl "stlport_static"
            ldLibs "log"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.4.0'
    compile 'com.android.support:design:23.4.0'
}

其中ndk节点下面的字段说明如下：

名称	说明
moduleName	模块名称，即编译出来的.so的名字
stl	默认情况下JNI中是无法使用STL标准库的，加入此字段表示使用STL标准库。
ldLibs	“log”  表示加入Android的调试日志，只要在导入#include

3. 编写JNI接口

创建一个叫JNIUtil的Java类，并声明一个使用native关键字修饰的test方法，代码如下：

package vimfung.cn.jnisample;

/**
 * Created by vimfung on 16/9/8.
 */
public class JNIUtil
{
   
    public native String test ();
}

* 注：声明jni的方法必须带有native关键字，否则将视为一般的方法。设置native的方法允许为静态/非静态方法（即加或不加static关键字）。*

Command+F9（或菜单“Build”－“Make Project”）进行编译，成功后点击界面最下面的Terminal按钮打开终端面板（终端会自动定位到当前项目目录非常方便^o^）。使用cd命令跳转到app/build/intermediates/classes/debug/目录下，输入脚本如下：

$ cd app/build/intermediates/classes/debug/

使用javah命令生成刚才创建的JNIUtil类的JNI的头文件(.h文件)，如：

javah vimfung.cn.jnisample.JNIUtil

* 这里要注意的是javah要根据包名来对应目录路径来查找对应的.class文件，所以定位的目录必须要在包目录结构的上一级（即这里的debug目录），否则会提示找不到对应的类。*

执行成功后（执行成功是不会输出任何信息的，错误了才会提示-_-#）会在debug目录下多出一个vimfung_cn_jnisample_JNIUtil.h的头文件，如下所示：

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class vimfung_cn_jnisample_JNIUtil */

#ifndef _Included_vimfung_cn_jnisample_JNIUtil
#define _Included_vimfung_cn_jnisample_JNIUtil
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     vimfung_cn_jnisample_JNIUtil
 * Method:    test
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_vimfung_cn_jnisample_JNIUtil_test
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

可以看到刚才定义的test方法在头文件中被声明为Java_vimfung_cn_jnisample_JNIUtil_test 方法（其命名规则我猜应该是Java＋“”＋“包名1”＋“” ＋“包名2”＋“”…＋“”＋“类名”＋“_”＋“方法名”）。其中有jstring、JNIEnv、jobject这些就是JNI提供给C/C++调用的类型和接口，利用这些东西可以跟Java层进行一些交互。

回到Android Studio中，右键app目录，在弹出菜单中选择“New”－“Folder”－“JNI Folder”建立一个JNI的目录。如图：

然后把刚才生成的头文件拷贝到这个目录下，最终效果如图：

创建一个c++的文件，名字叫vimfung_cn_jnisample_JNIUtil.cpp，然后Java_vimfung_cn_jnisample_JNIUtil_test方法进行实现，如：

//
// Created by vimfung on 16/9/8.
//
#include "vimfung_cn_jnisample_JNIUtil.h"

JNIEXPORT jstring JNICALL Java_vimfung_cn_jnisample_JNIUtil_test(JNIEnv *env, jobject obj)
{
    return env -> NewStringUTF("Hello World!");
}

该方法直接通过env构造一个Java的字符串返回值并赋值为“Hello World！”进行返回。关于JNI提供的接口功能在后面的章节会进行介绍，我们这里只要知道是返回字符串就可以了。

现在再打开JNIUtil的Java类，让外部一旦使用该类时即加载JNISample.so这个库，修改如下：

package vimfung.cn.jnisample;

/**
 * Created by vimfung on 16/9/8.
 */
public class JNIUtil
{
   
    static
    {
        System.loadLibrary("JNISample");
    }

    public native String test ();
}

最后，打开MainActivity.java文件，添加一个JNIUtil的属性，并且在onCreate的时候初始化并调用test方法。这一步骤主要是验证我们的JNI接口是否正常运行，修改的代码如下：

public class MainActivity extends AppCompatActivity {
   

    private