詳解安卓系統中的Android.mk文件

概述
    Android.mk文件用來向編譯系統描述如何編譯你的源代碼。更確切地說，該文件其實就是一個小型的Makefile。因爲該文件會被NDK的編譯工具解析屢次，所以應該儘可能減小源碼中聲明變量，由於這些變量可能會被屢次定義從而影響到後面的解析。這個文件的語法容許把源代碼組織成模塊，每一個模塊屬於下列類型之一：

    APK程序：通常的Android程序，編譯打包生成apk文件。
    JAVA庫：java類庫，編譯打包生成jar包文件。
    C\C++應用程序：可執行的C/C++應用程序。
    C\C++靜態庫：編譯生產C/C++靜態庫，並打包成.a文件。
    C\C++共享庫：編譯生成共享庫，並打包成.so文件，有且只有共享庫才能被安裝/複製到APK包中。

舉例
    這裏參考了網上一個通用的例子，編譯簡單的「Hello World」，來講明一下Android.mk編寫。例以下面的文件：
1. sources/test/hello.c
2. sources/test/Android.mk
    其中「hello.c」是一個JNI共享庫，實現返回「hello world」字符串的原生方法。所以，Android.mk文件內容以下：

?

1 2 3 4 5

LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE := hello LOCAL_SRC_FILES := hello.c include $(BUILD_SHARED_LIBRARY)

    解釋一下這幾行代碼：
1. LOCAL_PATH := $(call my-dir) ： 一個Android.mk文件首先必須定義好LOCAL_PATH變量，用於在開發樹中查找源文件。在這個例子中，宏函數my-dir由編譯系統提供，用於返回當前路徑（即包含Android.mk文件的目錄）。
2. include $(CLEAR_VARS)：CLEAR_VARS由編譯i系統提供，指定讓GNU MAKEFILE清除除了LOCAL_PATH變量外的許多LOCAL_***變量（例如：LOCAL_MODULE、LOCAL_SRC_FILES等）。這是很是有必要的，由於全部的編譯文件都在同一個GUN MKAE執行環境中，全部的變量都是全局變量，不清除容易引發解析錯誤。
3. LOCAL_MODULE := hello：LOCAL_MODULE變量必須定義，用來標識在Android.mk文件描述的每個模塊。並且名稱必須是惟一的，而且不能包含空格。編譯系統會自動產生合適的前綴和後綴，好比一個被命名爲hello的共享庫模塊，將會生成libhello.so文件。若是把庫命名爲libhello，編譯系統將不會添加任何lib前綴，也會生成libhello.so文件。
4. LOCAL_SRC_FILES := hello.c：LOCAL_SRC_FILES變量必須包含將要編譯打包進模塊中的源代碼文件。
5. include $(BUILD_SHARED_LIBRARY)：BUILD_SHARED_LIBRARY是編譯系統提供的變量，指向一個GNU Makefile腳本（應該就是build/core目錄下的shared_library.mk）,負責收集自從上次調用include $(CLEAR_VARS)以來，定義在LOCAL_***變量中的全部信息，而且決定編譯什麼，如何正確地去作，並根據其規則生成靜態庫。
6. 解釋一下Android.mk裏變量定義字符":="。「:=」相似於c中的宏，即在定義處明確展開，徹底進行文本替換。

模塊描述變量
     下面的變量用於向系統描述咱們本身的模塊，它應該定義在include $(CLEAR_VARS)和include $(BUILD_***)之間。正如前面講述的那樣，$(CLEAR_VARS)是一個腳本，清除全部這些變量，除非在描述中顯示註明。
1. LOCAL_PATH：這個變量用於給出當前文件的路徑，必須在Android.mk的開頭定義，能夠這樣使用：LOCAL_PATH := $(call my-dir)，這樣這個變量不會被$(CLEAR_VARS)清除，由於每一個Android.mk只須要定義一次（即便一個文件中定義了多個模塊的狀況下）。
2. LOCAL_SRC_FILES：當前模塊包含的全部源代碼文件。
3. LOCAL_MODULE：當前模塊的名稱，這個名稱應當是惟一的，而且不能包含空格。模塊間的依賴關係就是經過這個名稱來引用的。
4. LOCAL_MODULE_CLASS：標識所編譯模塊最後放置的位置。ETC表示放置在/system/etc.目錄下，APPS表示放置在/system/app目錄下，SHARED_LIBRARIES表示放置在/system/lib目錄下。若是具體指定，則編譯的模塊不會放到編譯系統中，最後會在out對應product的obj目錄下的對應目錄中。
5. LOCAL_SRC_FILES：這是要編譯的源代碼文件列表。只要列出要傳遞給編譯器的文件便可，編譯系統會自動計算依賴關係。源代碼文件路徑都是相相對於LOCAL_PATH的，所以可使用相對路徑進行描述。
6. LOCAL_JAVA_LIBRARIES：當前模塊依賴的Java共享庫，也叫Java動態庫。例如framework.jar包。
7. LOCAL_STATIC_JAVA_LIBRARIES：當前模塊依賴的Java靜態庫，在Android裏，導入的jar包和引用的第三方工程都屬於Java靜態庫。
8. LOCAL_STATIC_LIBRARIES：當前模塊在運行時依賴的靜態庫的名稱。
9. LOCAL_SHARED_LIBRARIES：當前模塊在運行時依賴的動態庫的名稱。
10. LOCAL_C_INCLUDES：c或c++語言須要的頭文件的路徑。
11. LOCAL_CFLAGS：提供給C/C++編譯器的額外編譯參數。
12. LOCAL_PACKAGE_NAME：當前APK應用的名稱。
13. LOCAL_CERTIFICATE：簽署當前應用的證書名稱。
14. LOCAL_MODULE_TAGS：當前模塊所包含的標籤，一個模塊能夠包含多個標籤。標籤的值多是eng、user、debug、development、optional。其中，optional是默認標籤。
15. LOCAL_DEX_PREOPT：apk的odex優化開關，默認是false。

    除此以外，Build系統中還定義了一些函數方便在Android.mk中使用，包括： 1. $(call my-dir)：獲取當前文件夾的路徑。 2. $(call all-java-files-under, <src>)：獲取指定目錄下的全部java文件。 3. $(call all-c-files-under, <src>)：獲取指定目錄下的全部c文件。 4. $(call all-Iaidl-files-under, <src>)：獲取指定目錄下的全部AIDL文件。 5. $(call all-makefiles-under, <folder>)：獲取指定目錄下的全部Make文件。 6. $(call intermediates-dir-for, <class>, <app_name>, <host or target>, <common?>)：獲取Build輸入的目標文件夾路徑。