原文:http://xiazdong.me/2015/09/17/introduction-jni-ndk/
前言
JNI(Java Native Interface) 是 Java 提供的調(diào)用 C/C++ 代碼的一種方式着茸。同時帶來的壞處是讓 Java 喪失了跨平臺的特性宙暇,因為 C/C++ 編譯后的二進制代碼在不同機器(不同指令集俏扩、架構(gòu))上并不通用沟饥。
NDK(Native Development Kit) 是 Android 提供的調(diào)用 C/C++ 代碼的方法证芭,他是基于 JNI 的毫目。通過 NDK 能夠更快的將 C/C++ 代碼編譯成支持多個平臺(ARM, X86, mips)的動態(tài)庫帝际。
本文的操作系統(tǒng)是 Mac OS X挠轴,開發(fā)環(huán)境是 Android Studio势篡。
基本概念
Java 中通過 System.loadLibrary("<name>")
導(dǎo)入動態(tài)庫翩肌,而不同平臺下動態(tài)庫的表示都不同。Windows 下以 "<name>.dll" 命名禁悠,Linux 下用 "lib<name>.dll" 命名念祭,Mac 下用 "lib<name>.jnilib" 命名。
JNI 例子
1碍侦、在工作目錄創(chuàng)建 "JniTest.java"棒卷。
package com.xiazdong;
public class JniTest{
static{
System.loadLibrary("jnitest");
}
public static void main(String[]args){
JniTest test = new JniTest();
System.out.println(test.add(1,2));
}
public native int add(int a, int b);
}
可以看出在 JniTest 類中有一個 add 的 native 方法,其實現(xiàn)為本地代碼祝钢。
System.loadLibrary("jnitest")
表示導(dǎo)入動態(tài)庫比规,但是在不同平臺表示意義不同,Windows 表示導(dǎo)入 "jnitest.dll"拦英,Linux 表示導(dǎo)入 "libjnitest.so"蜒什,Mac 表示導(dǎo)入 "libjnitest.jnilib"。
2疤估、命令行執(zhí)行 javac -d . JniTest.java
生成 class 文件灾常。
3、命令行執(zhí)行 javah com.xiazdong.JniTest
生成 com_xiazdong_JniTest.h
文件铃拇,該文件命令為 <包名>_<類名>.h
钞瀑。
4、在工作目錄創(chuàng)建 test.c
文件慷荔。
#include "com_xiazdong_JniTest.h"
#include <stdio.h>
JNIEXPORT jint JNICALL Java_com_xiazdong_JniTest_add(JNIEnv * env, jobject thiz, jint a, jint b){
return a + b; //具體實現(xiàn)
}
其中函數(shù)的定義可以從 com_xiazdong_JniTest.h
中拷貝過來雕什。函數(shù)命名規(guī)定為Java_<包名>_<類名>_<方法名>
。
5、命令行執(zhí)行 gcc -shared -I $JAVA_HOME/include -I $JAVA_HOME/include/darwin -fPIC test.c -o libjnitest.jnilib
。該命令生成 "libjnitest.jnilib"头镊。如果是 Linux 環(huán)境,則把該命令的 libjnitest.jnilib
改成 libjnitest.so
即可偿警。
此時生成的動態(tài)庫是在工作目錄下的。
6唯笙、命令行執(zhí)行 java com.xiazdong.JniTest
螟蒸。
如果要引入的動態(tài)庫不在工作目錄中盒使,需要通過該命令加入動態(tài)庫的目錄 -Djava.library.path=<dir>
。
NDK 例子
0七嫌、下載ndk少办,本文使用 "android-ndk-r10e-darwin-x86_64.bin"。
執(zhí)行 sudo chmod a+x android-ndk-r10e-darwin-x86_64.bin
抄瑟。
執(zhí)行 sudo ./android-ndk-r10e-darwin-x86_64.bin
解壓凡泣。
將解壓后的 android-ndk-r10e
目錄添加到 PATH 環(huán)境變量枉疼。
1皮假、創(chuàng)建 jni 目錄,注意這里目錄名一定要是 jni骂维。
2惹资、在 jni 目錄中創(chuàng)建 test.c。
#include "jni.h"
#include <stdio.h>
#ifdef __cplusplus
extern "C" {
#endif
jint Java_me_xiazdong_ndkdemo_Test_add(JNIEnv * env, jobject thiz, jint a, jint b){
return a + b;
}
#ifdef __cplusplus
}
#endif
注意:此處包名為 me.xiazdong.ndkdemo航闺,類名為 Test褪测。這個需要特別注意!潦刃!
3侮措、在 jni 目錄中創(chuàng)建 Android.mk。
LOCAL_PATH := $(call my-dir) ## 定義 LOCAL_PATH 環(huán)境變量為本文件的目錄乖杠,mydir 表示當(dāng)前目錄分扎。
include $(CLEAR_VARS) ## 清除除了 LOCAL_PATH 以外其他的 LOCAL_ 環(huán)境變量
LOCAL_MODULE := jnitest ## 動態(tài)庫名字為 jnitest
LOCAL_SRC_FILES := test.c ## 源文件名字
include $(BUILD_SHARED_LIBRARY) ## 編譯生成共享動態(tài)庫
4、在 jni 目錄下創(chuàng)建 Application.mk胧洒。
APP_ABI := all ## 表示生成所有平臺的動態(tài)庫畏吓。
5、執(zhí)行 cd ..
卫漫,即跳到 jni 目錄的父目錄菲饼,并執(zhí)行 ndk-build
。
此時就生成了 libs 目錄列赎,該目錄中有以下目錄宏悦,每個目錄都有 "libjnitest.so":
arm64-v8a
armeabi
armeabi-v7a
mips
mips64
x86
x86_64
6、新建 Android 工程包吝,將 libs 中的所有目錄拷貝到 "src/main/jniLibs" 中肛根,這是 Android Studio 識別的默認目錄。
7漏策、在 me.xiazdong.ndkdemo 包下創(chuàng)建 Test 類派哲。
package me.xiazdong.ndkdemo;
public class Test {
static{
System.loadLibrary("jnitest");
}
public native int add(int a, int b);
}
8、調(diào)用 Test 的 add 方法掺喻。
Test t = new Test();
int c = t.add(1,2);