学习JNI编程第2篇--导入/调用第三方so库

软硬件环境：
MacBook Pro, OS X El Capitan, 10.11.6
Android Studio v2.3

2017.11.1更新：
本代码已经整理上传到github.com，代码后来更新过，所以内容跟本文有出入。
链接：https://github.com/YigangFang/FactorialDemo

实际工作中，我们常常会拿到没有源码的第三方so库，使用它们进行APP开发。

在【学习JNI编程 第一篇】中，我们成功地编译出了一个计算阶乘的so库。在本篇中，我们要使用这个so库，假设在没有源码的情况下，开发一个APP。

1. 新建一个Android Studio项目

给项目命名，其它设置都保持默认即可。

项目创建好以后，设置视图为Project。

2. 把得到的so库复制到项目的libs目录下

我们实际从第三方得到的so库可能是针对多个平台的，无论如何，把需要的库复制到libs下面即可。

注意目录结构：

3. 编写jni文件

除了此项目默认生成的MainActivity以外，我们新建一个package包，包名是ai.nixie.aiden.factorialdemo.Factorial，严格跟so库的一致。

在里面加了一行native的声明，Factorial.java的全部内容如下：

package ai.nixie.aiden.factorialdemo;

/**
 * Created by Aiden Fang on 8/10/17.
 */

public class Factorial {

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

    public static native long facNTV(long n);

}

注意：
这里loadLibrary进来的库，是不包括lib前缀和.so后缀的。

4. 指定库文件所在目录

在build.gradle里的Android{}下，加入这样一段。

sourceSets {
    main {
        jniLibs.srcDirs = ['src/main/libs']
    }
}

注意，src/main/libs要根据你的库文件的实际存放目录进行相应修改。

5. 在MainActivity里，调用so库定义的函数

内容如下

package ai.nixie.aiden.sodemo;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;

import static ai.nixie.aiden.factorialdemo.Factorial.facNTV;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        TextView tv = (TextView) findViewById(R.id.tvRes);
        tv.setText(String.format("fac(6) = %d", facNTV(6)));
    }
}

其实就2个地方，一是import库函数那一行，二是调用facNTV函数。

6. 布局Layout文件 activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_height="match_parent"
    android:layout_width="match_parent">

    <TextView
        android:id="@+id/tvRes"
        android:textAlignment="center"
        android:textSize="32dp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        />

</LinearLayout>

7. 成功！

最终的项目树

说明

1. 因为我们得到的是已经编译好的so库，所以build.gradle中不再需要ndk段落。
2. 当java层加载so库时，因为是静态注册，所以需要在Factorial.java这个类中用loadLibrary来加载库。
3. 在build.gradle中的jniLibs的路径是从build.gradle这个文件所在的目录开始计算的，所以要注意跟so库文件实际存放目录匹配。