AndroidStudio通過ndk使用第三方動態連結庫
使用AndroidStudio的experimental plugin或是傳統的Android.mk,通過jni封裝呼叫第三方動態連結庫的方法有共通之處,也有不同之處。
原理
首先要了解gcc的引數,這裡不詳細講太多了,只說幾個常見的:
* -D用於在編譯時定義巨集,-DHH等於#define HH 1,-DHH=3等於#define HH 3
* -I用於指定標頭檔案的查詢路徑
* -L用於指定連結庫的查詢目錄,-l用於指定連結庫的名字,兩者結合,就可以指定動態連結庫了。
但是我們並不是直接使用gcc命令來進行編譯,所以接著往下看。
我們知道Android.mk其實就是特殊的MakeFile檔案,有一些約定的格式,而MakeFile檔案中有CFLAG、CPPFLAG和LDFLAG,他們有什麼區別呢?前兩者是用於指定編譯引數的,後者是用於指定連結引數的。
編譯引數,就是在編譯階段生效的引數,比如-D,-I等;
而連結引數,就是在連結階段生效的引數,也就是-L和-l。
最後,落實到程式碼上如下:
experimental plugin:
關於experimental plugin的使用請看官網介紹,如果要依賴第三方動態連結庫,只需要新增如下程式碼:
ndk {
ldFlags.addAll (["-L${file("jni/libs")}".toString()])
ldLibs.addAll(['mylib1', 'mylib2', 'mylib3'])
}
普通build.gradle結合Android.mk:
在AndroidStudio中使用Android.mk來編譯jni,需要將工程目錄結構設定成如下:
有兩種方式來依賴第三方動態連結庫:
1. 在module的build.gradle中新增如下程式碼:
import org.apache.tools.ant.taskdefs.condition.Os
apply plugin: 'com.android.application'
android {
compileSdkVersion 23
buildToolsVersion "23.0.2"
defaultConfig {
applicationId "com.my.appid"
minSdkVersion 10
targetSdkVersion 23
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
sourceSets {
main {
// Don't use native sources building using gradle,
// since gradle ignores custom Android.mk
jni.srcDirs = []
jniLibs.srcDirs = ['libs']
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
testCompile 'junit:junit:4.12'
compile 'com.android.support:appcompat-v7:23.1.1'
}
task buildNative(type: Exec, description: 'Compile JNI source via NDK') {
def ndkPath = android.ndkDirectory
if (ndkPath != null) {
ndkPath = ndkPath.absolutePath;
}
if (ndkPath == null) {
throw new GradleException("NDK not found.")
}
if (Os.isFamily(Os.FAMILY_WINDOWS)) {
commandLine ndkPath + '/ndk-build.cmd',
'-C', file('.').absolutePath,
'-j', Runtime.runtime.availableProcessors(),
'all'
} else {
commandLine "sh", ndkPath + '/ndk-build',
'-C', file('.').absolutePath,
'-j', Runtime.runtime.availableProcessors(),
'all'
}
doLast {
if (execResult.exitValue != 0) {
throw new GradleException()
}
}
}
task cleanNative(type: Exec, description: 'Clean JNI object files') {
def ndkPath = android.ndkDirectory
if (ndkPath != null) {
ndkPath = ndkPath.absolutePath;
}
if (ndkPath == null) {
throw new GradleException("NDK not found.")
}
if (Os.isFamily(Os.FAMILY_WINDOWS)) {
commandLine ndkPath + '/ndk-build.cmd',
'-C', file('.').absolutePath,
'clean'
} else {
commandLine "sh", ndkPath + '/ndk-build',
'-C', file('.').absolutePath,
'clean'
}
doLast {
if (execResult.exitValue != 0) {
throw new GradleException()
}
}
}
clean.dependsOn 'cleanNative'
tasks.withType(JavaCompile) {
compileTask -> compileTask.dependsOn buildNative
}
build.gradle的原始碼可以參考這個專案中的build
在Android.mk中使用PREBUILT(PREBUILT_SHARED_LIBRARY或PREBUILT_STATIC_LIBRARY),具體看程式碼:
LOCAL_PATH := $(call my-dir)
#=================================================================================
include $(CLEAR_VARS)
LOCAL_MODULE := a
LOCAL_SRC_FILES := libs/a.so
include $(PREBUILT_SHARED_LIBRARY)
#=================================================================================
include $(CLEAR_VARS)
LOCAL_MODULE := b
LOCAL_SRC_FILES := libs/b.so
include $(PREBUILT_SHARED_LIBRARY)
#=================================================================================
include $(CLEAR_VARS)
LOCAL_MODULE := c
LOCAL_SRC_FILES := libs/c.so
include $(PREBUILT_SHARED_LIBRARY)
#=================================================================================
include $(CLEAR_VARS)
LOCAL_MODULE := final
LOCAL_SRC_FILES := \
src.c
LOCAL_SHARED_LIBRARIES := a b c
include $(BUILD_SHARED_LIBRARY)
這種方法是一般教程推薦的方法,它的好處是無論生成多少abi,都會自動生成liba.so、libb.so、libc.so和libfinal.so。
2. 在Android.mk中使用LOCAL_LDFLAGS來指定第三方動態連結庫,如下:
include $(CLEAR_VARS)
LOCAL_MODULE := final
LOCAL_SRC_FILES := \
src.c
LOCAL_LDFLAGS := -L$(LOCAL_PATH)/libs/ -la -lb -lc
include $(BUILD_SHARED_LIBRARY)
這種方法的缺點就是liba.so、libb.so和libc.so不會自動新增到abi中,需要手動新增,或者事先把它們複製到其他abi目錄中,然後使用如下配置使用:
sourceSets {
main {
// Don't use native sources building using gradle,
// since gradle ignores custom Android.mk
jni.srcDirs = []
jniLibs.srcDirs = ['libs','src/main/jniLibs']
}
}
普通build.gradle:
目前無法設定ldFlags,所以我還不知道怎麼設定,如果有知道的可以告訴我。。。