軟硬件環境:
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. 成功!
最終的項目樹
說明
- 因為我們得到的是已經編譯好的so庫,所以build.gradle中不再需要ndk段落。
- 當java層加載so庫時,因為是靜態注冊,所以需要在Factorial.java這個類中用loadLibrary來加載庫。
- 在build.gradle中的jniLibs的路徑是從build.gradle這個文件所在的目錄開始計算的,所以要注意跟so庫文件實際存放目錄匹配。