转载注明出处:简书-十个雨点
使用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,所以我还不知道怎么设置,如果有知道的可以告诉我。。。