08月26, 2016

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,需要将工程目录结构设置成如下:

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,所以我还不知道怎么设置,如果有知道的可以告诉我。。。

转载注明出处:十个雨点

本文链接:http://www.siki.space/post/as_use_third_party_so_through_ndk.html

-- EOF --

Comments