Android NDK學習筆記4-Android.mk篇

Android.mk是一個向Android NDK構建系統描述NDK項目的GUN Makefile片斷。它是每個NDK項目的必備組件，構建系統但願它出如今jni子目錄中。java

上圖就是Android.mk的基本文件格式，咱們來一塊兒學習下Android.mk的編寫語法。android

（一）基本使用

（一）Android.mk文件首先必需要指定LOCAL_PATH變量，用於查找源文件。因爲通常狀況下
Android.mk和須要編譯的源文件在同一目錄下，因此定義成以下形式：ruby

LOCAL_PATH:=$(call my-dir)

上面的語句的意思是將LOCAL_PATH變量定義成本文件所在目錄路徑。markdown

（二）Android.mk中能夠定義多個編譯模塊，每一個編譯模塊都是模塊化

以include $(CLEAR_VARS)開始，以include $(BUILD_XXX)結束

CLEAR_VARS由編譯系統提供，指定讓GNU MAKEFILE爲你清除除LOCAL_PATH之外的全部LOCAL_XXX變量，清楚它們能夠避免衝突，每個原生組件被稱爲一個模塊。如LOCAL_MODULE，LOCAL_SRC_FILES，LOCAL_SHARED_LIBRARIES，LOCAL_STATIC_LIBRARIES等。
● LOCAL_MODULE變量用來給這些模塊設定一個惟一的名稱，例如：函數

LOCAL_MODULE ：= hello-jni

● LOCAL_SRC_FILES變量定義用來創建和組裝這個模塊的源文件列表，例如：學習

LOCAL_SRC_FILES：= hello-jni.c

（二）經常使用構建系統變量講解

構建共享庫

爲了創建可供主應用程序使用的模塊，必須將該模塊變成共享庫。Android NDK構建系統將BUILD_STATIC_LIBRARY變量設置成build-shared-library.mk文件的保存位置。測試

include $(BUILD_STATIC_LIBRARY)

構建多個共享庫

基於不一樣應用程序的體系結構，一個單獨的Android.mk文件可能產生多個共享庫模塊，爲了達到這個目的，須要在Android.mk文檔中定義多個模塊。例如：ui

LOCAL_PATH := $(call my-dir)

#模塊1

include $(CLEAR_VARS)
LOCAL_MODULE    := hello-jni1
LOCAL_SRC_FILES := hello-jni1.c

include $(BUILD_SHARED_LIBRARY)

#模塊2

include $(CLEAR_VARS)
LOCAL_MODULE    := hello-jni2
LOCAL_SRC_FILES := hello-jni2.c

include $(BUILD_SHARED_LIBRARY)

在處理完這個Android.mk構建文檔以後，Android NDK構建系統會產生libhello-jni1.so和libhello-jni2.so兩個共享庫。this

構建靜態庫

Android NDK構建系統也支持靜態庫，靜態庫能夠用來構建共享庫，例如，在將第三方代碼添加到現有原生項目中，不用直接將第三方源代碼包括在原生項目中，而是將第三方代碼編譯成靜態庫，而後併入共享庫。

LOCAL_PATH := $(call my-dir)

#第三方AVI庫
include $(CLEAR_VARS)

LOCAL_MODULE    := avilib
LOCAL_SRC_FILES := avilib.c

include $(BUILD_SHARED_LIBRARY)

#原生模塊
include $(CLEAR_VARS)

LOCAL_MODULE    := hello-jni
LOCAL_SRC_FILES := hello-jni.c

LOCAL_SHARED_LIBRARIES：=avilib

include $(BUILD_SHARED_LIBRARY)

將第三方代碼模塊生成靜態庫後，共享庫就能夠經過將它的模塊名稱添加到LOCAL_SHARED_LIBRARIES變量中來使用該模塊。

用公共庫共享通用模塊

靜態庫能夠保證源代碼模塊化，可是，當靜態庫與共享庫相鏈接時，就變成了共享庫的一部分。在多個共享庫的狀況下，多個共享庫與同一個靜態庫鏈接時，須要將通用模塊的多個副本與不一樣共享庫重複鏈接，這樣就增長了應用程序的大小，在這種狀況下，咱們不用構建靜態庫，而是將通用模塊做爲共享庫創建起來，而動態鏈接依賴模塊以便消除重複的副本。

LOCAL_PATH := $(call my-dir)

#第三方AVI庫
include $(CLEAR_VARS)

LOCAL_MODULE    := avilib
LOCAL_SRC_FILES := avilib.c
include $(BUILD_SHARED_LIBRARY)

#原生模塊1

include $(CLEAR_VARS)
LOCAL_MODULE    := hello-jni1
LOCAL_SRC_FILES := hello-jni1.c
LOCAL_SHARED_LIBRARIES：=avilib

include $(BUILD_SHARED_LIBRARY)

#原生模塊2

include $(CLEAR_VARS)
LOCAL_MODULE    := hello-jni2
LOCAL_SRC_FILES := hello-jni2.c
LOCAL_SHARED_LIBRARIES：=avilib

include $(BUILD_SHARED_LIBRARY)

在多個NDK項目間共享模塊

同時使用靜態庫和共享庫時，能夠在模塊間共享通用模塊。可是要注意的是，全部這些模塊必須屬於同一個NDK項目。
1.首先將avilib源代碼移動到當前NDK項目之外的位置，如：D:\shared-moudles\transcode\avilib
2.做爲共享模塊，avilib須要本身的Android.mk文件，具體配置以下：

LOCAL_PATH := $(call my-dir)

#第三方AVI庫
include $(CLEAR_VARS)

LOCAL_MODULE    := avilib
LOCAL_SRC_FILES := avilib.c
include $(BUILD_SHARED_LIBRARY)

3.如今能夠將avilib模塊從當前NDK項目的Android.mk文件中移除。一般，爲了不衝突，咱們將以transcode/avilib爲參數調用函數宏import-module不分添加在構建文檔的末尾。

#原生模塊
include $(CLEAR_VARS)

LOCAL_MODULE    := hello-jni1
LOCAL_SRC_FILES := hello-jni1.c
LOCAL_SHARED_LIBRARIES：=avilib

include $(BUILD_SHARED_LIBRARY)

$(call import-module,transcode/avilib)

4.import-module函數宏須要先定位共享模塊，而後將它導入到NDK項目中。默認狀況下，import-module函數宏只搜索/sources目錄。爲了搜索D:\shared-moudles目錄，定義一個名爲NDK_MODULE_PATH的新環境變量並將它設置成共享模塊的根目錄，例如D:\shared-moudles。

用Prebuilt庫

prebulit庫有兩大做用：
1.想在不發佈源代碼的狀況下將你的模塊發佈給他人
2.想使用共享模塊的預建版來加速構建過程

LOCAL_PATH := $(call my-dir)

#第三方AVI庫
include $(CLEAR_VARS)

LOCAL_MODULE    := avilib
LOCAL_SRC_FILES := libavilib.so
include $(PREBUILT_SHARED_LIBRARY)

其中，LOCAL_SRC_FILES 變量指向的不是源文件，而是實際Prebuild庫相對於LOCAL_PATH的位置。

構建獨立的可執行文件

有時候爲了方便快速測試和原型設計，咱們可能會須要Android NDK構建獨立的可執行文件，它們不用打包成APK文件既能夠賦值到android設備上的常規Linux應用程序，並且它們能夠直接執行，而不經過java應用程序加載。生成獨立的能夠執行文件須要再Android.mk構建文檔中導入BUILD_EXECUTABLE變量。

#獨立可執行的原生模塊
include $(CLEAR_VARS)

LOCAL_MODULE    := moudles
LOCAL_SRC_FILES := moudles.c
LOCAL_SHARED_LIBRARIES：=avilib

include $(BUILD_EXECUTABLE)

獨立的可執行文件以與模塊相同的名稱放在libs/目錄下。

構建系統宏函數

my-dir:返回當前 Android.mk 所在的目錄的路徑，相對於 NDK 編譯系統的頂層。這是有用的，在 Android.mk 文件的開頭如此定義：

LOCAL_PATH := $(call my-dir)

all-subdir-makefiles: 返回一個位於當前’my-dir’路徑的子目錄中的全部Android.mk的列表。
例如，某一子項目的目錄層次以下：

src/foo/Android.mk 
     src/foo/lib1/Android.mk 
     src/foo/lib2/Android.mk

若是 src/foo/Android.mk 包含一行： 
       include $(call all-subdir-makefiles) 
  那麼它就會自動包含 src/foo/lib1/Android.mk 和 src/foo/lib2/Android.mk。 
  這項功能用於向編譯系統提供深層次嵌套的代碼目錄層次。 
  注意，在默認狀況下，NDK 將會只搜索在 src/*/Android.mk 中的文件。

this-makefile: 返回當前Makefile 的路徑(即這個函數調用的地方)
parent-makefile: 返回調用樹中父 Makefile 路徑。即包含當前Makefile的Makefile 路徑。
grand-parent-makefile:返回調用樹中父Makefile的父Makefile的路徑

定義新變量

開發人員能夠定義其餘新變量來簡化他們的構建文件。以LOCAL_和NDK_前綴開頭的名稱預留給Android NDK構建系統使用，建議你們使用MY_開頭。例如：
MY_SRC_FILIES:=avilib.c

條件操做

Android.mk構建文件能夠包含某些關於這些變量的條件操做，例如，在某個體系結構中包含一個不一樣的源文件集：

……
ifeq($(TARGET_ARCH),arm)
LOCAL_SRC_FILES += armonly.c
else
LOCAL_SRC_FILES += generic.c
endif
……

其餘構建系統變量列表

TARGET_ARCH: 目標 CPU平臺的名字
TARGET_PLATFORM: Android.mk 解析的時候，目標 Android 平臺的名字

android-3 -> Official Android 1.5 system images 
       android-4 -> Official Android 1.6 system images 
       android-5 -> Official Android 2.0 system images

TARGET_ARCH_ABI: 暫時只支持兩個 value，armeabi 和 armeabi-v7a。。
TARGET_ABI: 目標平臺和 ABI 的組合，
LOCAL_PATH: 這個變量用於給出當前文件的路徑。
必須在 Android.mk 的開頭定義，能夠這樣使用：

LOCAL_PATH := $(call my-dir)

如當前目錄下有個文件夾名稱 src，則能夠這樣寫 $(call src)，那麼就會獲得 src 目錄的完整路徑 
   這個變量不會被$(CLEAR_VARS)清除，所以每一個 Android.mk 只須要定義一次(即便在一個文件中定義了幾個模塊的狀況下)。

LOCAL_MODULE: 這是模塊的名字，它必須是惟一的，並且不能包含空格。
必須在包含任一的$(BUILD_XXXX)腳本以前定義它。模塊的名字決定了生成文件的名字。
LOCAL_SRC_FILES: 這是要編譯的源代碼文件列表。
只要列出要傳遞給編譯器的文件，由於編譯系統自動計算依賴。注意源代碼文件名稱都是相對於 LOCAL_PATH的，你可使用路徑部分，例如：

LOCAL_SRC_FILES := foo.c toto/bar.c\ 
        Hello.c

文件之間能夠用空格或Tab鍵進行分割,換行請用"\" 
   若是是追加源代碼文件的話，請用LOCAL_SRC_FILES += 
   注意：能夠LOCAL_SRC_FILES := $(call all-subdir-java-files)這種形式來包含local_path目錄下的全部java文件。

LOCAL_C_INCLUDES: 可選變量，表示頭文件的搜索路徑。
默認的頭文件的搜索路徑是LOCAL_PATH目錄。
LOCAL_STATIC_LIBRARIES: 表示該模塊須要使用哪些靜態庫，以便在編譯時進行連接。
LOCAL_SHARED_LIBRARIES: 表示模塊在運行時要依賴的共享庫（動態庫），在連接時就須要，以便在生成文件時嵌入其相應的信息。
注意：它不會附加列出的模塊到編譯圖，也就是仍然須要在Application.mk 中把它們添加到程序要求的模塊中。
LOCAL_LDLIBS: 編譯模塊時要使用的附加的連接器選項。這對於使用‘-l’前綴傳遞指定庫的名字是有用的。
例如，LOCAL_LDLIBS := -lz表示告訴連接器生成的模塊要在加載時刻連接到/system/lib/libz.so
可查看 docs/STABLE-APIS.TXT 獲取使用 NDK發行版能連接到的開放的系統庫列表。
LOCAL_MODULE_PATH 和 LOCAL_UNSTRIPPED_PATH:
在 Android.mk 文件中，還能夠用LOCAL_MODULE_PATH 和LOCAL_UNSTRIPPED_PATH指定最後的目標安裝路徑.
不一樣的文件系統路徑用如下的宏進行選擇：
TARGET_ROOT_OUT：表示根文件系統。
TARGET_OUT：表示 system文件系統。
TARGET_OUT_DATA：表示 data文件系統。
用法如：LOCAL_MODULE_PATH :=$(TARGET_ROOT_OUT)
至於LOCAL_MODULE_PATH 和LOCAL_UNSTRIPPED_PATH的區別，暫時還不清楚。
LOCAL_JNI_SHARED_LIBRARIES：定義了要包含的so庫文件的名字，若是程序沒有采用jni，不須要 LOCAL_JNI_SHARED_LIBRARIES := libxxx 這樣在編譯的時候，NDK自動會把這個libxxx打包進apk；放在youapk/lib/目錄下