前言

之前一直是用Eclipse开发的，后来转AndroidStudio的时候遇到了一些坑，其中比较麻烦的就是NDK的编译。

代码已上传至GitHub

myExample是我创建专门用来放小例子的，以后我写文章需要的例子就都放这里面了。

正文

1.原理

之前用Eclipse的时候都是手动创建一个jni文件夹，然后自己添加Android.mk和Application.mk2个文件，最后通过执行ndk-build命令生成so库。

但是AndroidStudio自带编译so库功能，它会通过build.gradle里面的android.ndk项自动生成Android.mk文件然后生成so库，我们需要做的就是禁止它自带的功能，使用我们自己的mk文件。

实现步骤

禁止AndroidStudio自带的ndk功能。

添加gradle task自动调用ndk-build命令。

首先看下文件目录

文件目录

2.配置

1.禁止AndroidStudio自带的ndk功能

完整配置请看build.gradle sourceSets

android {
    //... 省略其他配置
    sourceSets {
        main {
            jni.srcDirs = [] //禁止自带的ndk功能
            jniLibs.srcDir 'src/main/libs' //重定向so目录为src/main/libs
        }
    }
}

2.添加gradle task自动调用ndk-build命令

完整配置请看build.gradle task

android {
    //... 省略其他配置

    tasks.withType(JavaCompile) {
        compileTask -> compileTask.dependsOn ndkBuild
    }

    task ndkBuild(type: Exec, description: 'Compile JNI source with NDK') {
        Properties properties = new Properties()
        properties.load(project.rootProject.file('local.properties').newDataInputStream())
        def ndkDir = properties.getProperty('ndk.dir')//获得ndk目录

        //执行ndk-build命令
        if (Os.isFamily(Os.FAMILY_WINDOWS)) {//如果是win系统
            //commandLine "$ndkDir/ndk-build.cmd", 'NDK_DEBUG=1', '-C', file('src/main/jni').absolutePath //debug命令，如果需要做调试可以使用这条命令
            commandLine "$ndkDir/ndk-build.cmd", '-C', file('src/main/jni').absolutePath//这里指定了jni的目录位置
        } else {
            //commandLine "$ndkDir/ndk-build", 'NDK_DEBUG=1', '-C', file('src/main/jni').absolutePath
            commandLine "$ndkDir/ndk-build", '-C', file('src/main/jni').absolutePath
        }
    }

    task ndkClean(type: Exec, description: 'Clean NDK Binaries') {
        Properties properties = new Properties()
        properties.load(project.rootProject.file('local.properties').newDataInputStream())
        def ndkDir = properties.getProperty('ndk.dir')//获得ndk目录

        //执行ndk-build clear命令
        if (Os.isFamily(Os.FAMILY_WINDOWS)) {//如果是win系统
            commandLine "$ndkDir/ndk-build.cmd", 'clean', '-C', file('src/main/jni').absolutePath
        } else {
            commandLine "$ndkDir/ndk-build", 'clean', '-C', file('src/main/jni').absolutePath
        }
    }

    clean.dependsOn 'ndkClean'
}

在生成so库后可以把它注释了，不然jni文件多了生成会比较慢。

千万别忘了在local.properties里配置ndk.dir不然会找不到ndk。

3.实现

在build.gradle配置了上述语句后就可以自动生成so库了。

接下来让我们来实现一个HelloJni试下。

1.创建Application.mk和Android.mk文件

Application.mk文件非常简单，就是一句APP_ABI := all，它的意思是生成所有架构的so库，在平常使用中我们一般会有选择性的设置为APP_ABI := armeabi armeabi-v7a x86。

Android.mk文件比较复杂，推荐看《Android.mk、Application.mk》写的比较详细，我这里写的比较简单。

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)

LOCAL_MODULE    := HelloJni#模块的名称，会在生成的so库前面加上lib，最终名称就是libHelloJni.so

LOCAL_SRC_FILES := HelloJni.cpp#要打包的源码
include $(BUILD_SHARED_LIBRARY)

2.创建Java文件

我们创建一个HelloJni.java文件，用于ndk交互，这个文件也特别简单，要注意的是我这里的hello()方法用的static，在jni里对应第二个参数为jclass，如果不是静态方法，就会对应jobject。

public class HelloJni {
    public static native String hello();
}

3.创建C++文件

首先需要创建.h文件，有二种创建方法，第一种就是手动创建，第二种就是利用javah.exe这个工具创建，我们这里就利用第二种方法来创建这个.h文件。

javah.exe这个工具在jdk的bin目录下，我们打开AndroidStudio的Terminal窗口然后输入javah.exe -d app/src/main/jni -cp app/src/main/java com.xiuyukeji.ndk_config.HelloJni回车后我们就能生成com_xiuyukeji_ndk_config_HelloJni.h文件。

这里有点需要注意，函数名对应java层的包名+类名+方法名，如果不是自动生成，要检查下函数名是否对应，不然会报UnsatisfiedLinkError错误。

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

#ifndef _Included_com_xiuyukeji_ndk_config_HelloJni
#define _Included_com_xiuyukeji_ndk_config_HelloJni
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_xiuyukeji_ndk_config_HelloJni
 * Method:    hello
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_xiuyukeji_ndk_1config_HelloJni_hello
  (JNIEnv *, jclass);

#ifdef __cplusplus
}
#endif
#endif

Terminal窗口

.H文件

我来解释下javah.exe这条命令的意思，-d代表输出目录在app/src/main/jni，-cp代表加载目录在app/src/main/java，最后的com.xiuyukeji.ndk_config.HelloJni就是文件名了。

Javah工具说明

javah.exe这个工具可以看下这篇文章《超级简单的Android Studio jni 实现(无需命令行)》

如果提示找不到javah.exe就说明你的环境变量需要在path里多加一句%JAVA_HOME%\bin。

输出.h文件后我们就可以开始写HelloJni.cpp了，代码特别简单，返回一个字符串Hello jni，我这里加了个extern "C"，意思是告诉编译器按照C进行编译，不加也可以，具体解释看这里《extern "c"用法解析》。

#include "com_xiuyukeji_ndk_config_HelloJni.h"

extern "C" {

    JNIEXPORT jstring JNICALL Java_com_xiuyukeji_ndk_1config_HelloJni_hello(JNIEnv * env, jclass jc){
        return (env)->NewStringUTF("Hello jni");
    }

}

然后我们可以开始生成so库了，执行Build->Build APK命令。

编译命令

编译过程

最终会在lib下生成各个架构的so库。

lib

4.调用So库

上面我们已经生成了so库，下面我们就需要在java层调用libHelloJni.so里面的hello函数。

在MainActivity里动态加载so库，一般加载so库都是利用static {}，这种写法叫静态代码块优先于其他代码执行。

static {
      System.loadLibrary("HelloJni");
}

调用HelloJni.hello()语句。

public class MainActivity extends AppCompatActivity {
    //... 省略其他代码
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
        fab.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Snackbar.make(view, HelloJni.hello(), Snackbar.LENGTH_LONG).show();
            }
        });
    }
}

最终结果

结尾

如果它有解决你的问题的话，请下点个赞，谢谢。

这是我个人的第三篇文章，写于2017年4月19日。

Android 从Eclipse转Android Studio的NDK配置方式