Android.mk
Android.mk是一個向Android NDK構(gòu)建系統(tǒng)描述NDK項(xiàng)目的GUN makefile片段。主要用來編譯生成以下幾種:
- APK程序:一般的Android應(yīng)用程序,系統(tǒng)級別的直接push即可
- JAVA庫:JAVA類庫,編譯打包生成JAR文件。
- C\C++應(yīng)用程序:可執(zhí)行的C\C++應(yīng)用程序蠢棱。
- C\C++靜態(tài)庫:編譯生成C\C++靜態(tài)庫
- C\C++共享庫:編譯生成共享庫,并打包成.so文件
Android.mk基本格式
# 定義模塊當(dāng)前路徑(必須定義在文件開頭,只需定義一次)
# my-dir是編譯系統(tǒng)提供的宏函數(shù) 返回mk當(dāng)前路徑
LOCAL_PATH := $(call my-dir)
# 清空當(dāng)前環(huán)境變量(以LOCAL_開頭除LOCAL_PATH外變量)
# CLEAR_VARS是 GUN Makefile提供的一段特定的Makefile片段
# 這樣做因?yàn)榫幾g系統(tǒng)在單次執(zhí)行中會解析多個構(gòu)建文件和模塊定義禀忆,而LOCAL_開頭的變量是全局變量,所以落恼,描述每個模塊前都會做此操作箩退,避免沖突
include $(CLEAR_VARS)
# 當(dāng)前模塊名(這里會生成libhello-jni.so)
LOCAL_MODULE := hello-jni
# 當(dāng)前模塊包含的源代碼文件(多個用“空格”隔開)
LOCAL_SRC_FILES := hello-jni.c
# 表示當(dāng)前模塊將被編譯成一個共享庫
include $(BUILD_SHARED_LIBRARY)
編譯多個共享庫
一個Android可能編譯產(chǎn)生多個共享庫模塊。
會產(chǎn)生libmodule1.so和libmodule2.so兩個動態(tài)庫
LOCAL_PATH := $(call my-dir)
# 模塊1
include $(CLEAR_VARS)
LOCAL_MODULE := module1
LOCAL_SRC_FILES := module1.c
include $(BUILD_SHARED_LIBRARY)
# 模2
include $(CLEAR_VARS)
LOCAL_MODULE := module2
LOCAL_SRC_FILES := module2.c
include $(BUILD_SHARED_LIBRARY)
編譯靜態(tài)庫
雖然Android應(yīng)用程序不能直接使用靜態(tài)庫佳谦,但可以使用靜態(tài)庫編譯成動態(tài)庫戴涝。比如講三方代碼添加到原生項(xiàng)目中時(shí),可以不用直接將第三方源碼包括在原生項(xiàng)目中钻蔑,而是將三方源碼編譯成靜態(tài)庫啥刻,然后并入共享庫。
LOCAL_PATH := $(call my-dir)
# 第三方AVI庫
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := avilib.c platform-posix.c
include $(BUILD_STATIC_LIBRARY)
# 原生模塊
include $(CLEAR_VARS)
LOCAL_MODULE := module
LOCAL_SRC_FILES := module.c
# 將靜態(tài)庫模塊名添加到LOCAL_STATIC_LIBRARIES變量
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
如果多個共享庫都是用到了avi庫咪笑,那么avi庫就是通用模塊可帽,我們可以使用共享庫共享通用模塊
使用共享庫共享通用模塊
靜態(tài)庫可以保證源代碼模塊化,但是當(dāng)靜態(tài)庫與共享庫相連時(shí)窗怒,它就變成了共享庫的一部分映跟。在多個共享庫的情況下,多個共享庫與靜態(tài)庫連接時(shí)扬虚,需要將通用模塊的多個副本與不同的共享庫重復(fù)相連申窘,這樣就增加了APP的大小。這種情況下可將通用模塊作為共享庫孔轴。
LOCAL_PATH := $(call my-dir)
# 第三方AVI庫
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := avilib.c platform_posix.c
include $(BUILD_SHARED_LIBRARY)
# 原生模塊1
include $(CLEAR_VARS)
LOCAL_MODULE := module1
LOCAL_SRC_FILES := module1.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
# 原生模塊2
include $(CLEAR_VARS)
LOCAL_MODULE := module2
LOCAL_SRC_FILES := module2.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
以上所有的模塊必須屬于同一NDK項(xiàng)目剃法,如果是多個NDK項(xiàng)目間如何處理呢?
在多個NDK項(xiàng)目間共享模塊
從NDKr5開始允許多個NDK項(xiàng)目共享重用模塊路鹰,使用 improt-module
- 將avilib源代碼移動到NDK以外的位置贷洲,比如C:\android\shared-modules\transcode\avilib
- avilib創(chuàng)建自己的Android.mk文件
- import-module需要先定位共享模塊,然后導(dǎo)入到NDK項(xiàng)目中晋柱,默認(rèn)import-module只搜索NDK目錄下sources目錄优构。如果想要搜索到其他目錄需要定義新環(huán)境變量NDK_MODULE_PATH并且設(shè)置成共享模塊的根目錄.
示例
# avilib模塊自己的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := avilib.c platform_posix.c
include $(BUILD_SHARED_LIBRARY)
# 使用共享模塊的NDK項(xiàng)目1的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := module1
LOCAL_SRC_FILES := module1.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
$(call import-module,transcode/avilib)
# 使用共享模塊的NDK項(xiàng)目2的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := module2
LOCAL_SRC_FILES := module2.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
$(call import-module,transcode/avilib)
使用預(yù)編譯庫
當(dāng)我們想在不發(fā)布源代碼的情況下將模塊發(fā)布給他人;想使用共享模塊的預(yù)編譯版來加速編譯過程雁竞。這時(shí)候我們就可以使用預(yù)編譯庫
# 預(yù)編譯共享模塊的Android.mk文件
LOCAL_PATH := $(call my-dir)
# 第三方預(yù)編譯的庫
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := libavilib.so
include $(PREBUILD_SHARED_LIBRARY)
編譯獨(dú)立的可執(zhí)行文件
為了方便測試和進(jìn)行加速開發(fā)钦椭,可以編譯成可執(zhí)行文件拧额。不用打包成APK就可以復(fù)制到Android設(shè)備上執(zhí)行
# 獨(dú)立可執(zhí)行模塊的Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := module
LOCAL_SRC_FILES := module.c
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_EXECUTABLE)
注意事項(xiàng)
假如我們本地庫 libhello-jni.so依賴于libTest.so(可以使用NDK下的ndk-depends查看so的依賴關(guān)系)
- Android6.0版本之前,需要在加載本地庫前先加載被依賴的so彪腔。
- Android6.0版本之后侥锦,不能在使用預(yù)編譯的動態(tài)庫(靜態(tài)庫沒問題)。
// Android 6.0版本之前 libhello-jni.so依賴于libTest.so 需要先加載libTest.so
System.loadLibrary("Test");
System.loadLibrary("hello-jni");
// Android 6.0版本之后
System.loadLibrary("hello-jni");