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

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容