詳解安卓系統中的Android.mk檔案_C 語言

概述
    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檔案內容如下：

  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輸入的目標檔案夾路徑。