快捷導(dǎo)航

詳解安卓系統(tǒng)中的Android.mk文件

更新時(shí)間：2015年07月31日 11:30:52 作者：低調(diào)小一

這篇文章主要介紹了詳解安卓系統(tǒng)中的Android.mk文件,該文件用來告訴系統(tǒng)關(guān)于源代碼的編譯,需要的朋友可以參考下

概述
Android.mk文件用來向編譯系統(tǒng)描述如何編譯你的源代碼。更確切地說，該文件其實(shí)就是一個(gè)小型的Makefile。由于該文件會(huì)被NDK的編譯工具解析多次，因此應(yīng)該盡量減少源碼中聲明變量，因?yàn)檫@些變量可能會(huì)被多次定義從而影響到后面的解析。這個(gè)文件的語法允許把源代碼組織成模塊，每個(gè)模塊屬于下列類型之一：

    APK程序：一般的Android程序，編譯打包生成apk文件。
    JAVA庫(kù)：java類庫(kù)，編譯打包生成jar包文件。
    C\C++應(yīng)用程序：可執(zhí)行的C/C++應(yīng)用程序。
    C\C++靜態(tài)庫(kù)：編譯生產(chǎn)C/C++靜態(tài)庫(kù)，并打包成.a文件。
    C\C++共享庫(kù)：編譯生成共享庫(kù)，并打包成.so文件，有且只有共享庫(kù)才能被安裝/復(fù)制到APK包中。

舉例
這里參考了網(wǎng)上一個(gè)通用的例子，編譯簡(jiǎn)單的“Hello World”，來說明一下Android.mk編寫。例如下面的文件：
1. sources/test/hello.c
2. sources/test/Android.mk
其中“hello.c”是一個(gè)JNI共享庫(kù)，實(shí)現(xiàn)返回“hello world”字符串的原生方法。因此，Android.mk文件內(nèi)容如下：

  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) ：一個(gè)Android.mk文件首先必須定義好LOCAL_PATH變量，用于在開發(fā)樹中查找源文件。在這個(gè)例子中，宏函數(shù)my-dir由編譯系統(tǒng)提供，用于返回當(dāng)前路徑（即包含Android.mk文件的目錄）。
2. include $(CLEAR_VARS)：CLEAR_VARS由編譯i系統(tǒng)提供，指定讓GNU MAKEFILE清除除了LOCAL_PATH變量外的許多LOCAL_***變量（例如：LOCAL_MODULE、LOCAL_SRC_FILES等）。這是非常有必要的，因?yàn)樗械木幾g文件都在同一個(gè)GUN MKAE執(zhí)行環(huán)境中，所有的變量都是全局變量，不清除容易引起解析錯(cuò)誤。
3. LOCAL_MODULE := hello：LOCAL_MODULE變量必須定義，用來標(biāo)識(shí)在Android.mk文件描述的每一個(gè)模塊。而且名稱必須是唯一的，并且不能包含空格。編譯系統(tǒng)會(huì)自動(dòng)產(chǎn)生合適的前綴和后綴，比如一個(gè)被命名為hello的共享庫(kù)模塊，將會(huì)生成libhello.so文件。如果把庫(kù)命名為libhello，編譯系統(tǒng)將不會(huì)添加任何lib前綴，也會(huì)生成libhello.so文件。
4. LOCAL_SRC_FILES := hello.c：LOCAL_SRC_FILES變量必須包含將要編譯打包進(jìn)模塊中的源代碼文件。
5. include $(BUILD_SHARED_LIBRARY)：BUILD_SHARED_LIBRARY是編譯系統(tǒng)提供的變量，指向一個(gè)GNU Makefile腳本（應(yīng)該就是build/core目錄下的shared_library.mk）,負(fù)責(zé)收集自從上次調(diào)用include $(CLEAR_VARS)以來，定義在LOCAL_***變量中的所有信息，并且決定編譯什么，如何正確地去做，并根據(jù)其規(guī)則生成靜態(tài)庫(kù)。
6. 解釋一下Android.mk里變量定義字符":="?！?=”類似于c中的宏，即在定義處明確展開，完全進(jìn)行文本替換。

模塊描述變量
下面的變量用于向系統(tǒng)描述我們自己的模塊，它應(yīng)該定義在include $(CLEAR_VARS)和include $(BUILD_***)之間。正如前面講述的那樣，$(CLEAR_VARS)是一個(gè)腳本，清除所有這些變量，除非在描述中顯示注明。
1. LOCAL_PATH：這個(gè)變量用于給出當(dāng)前文件的路徑，必須在Android.mk的開頭定義，可以這樣使用：LOCAL_PATH := $(call my-dir)，這樣這個(gè)變量不會(huì)被$(CLEAR_VARS)清除，因?yàn)槊總€(gè)Android.mk只需要定義一次（即使一個(gè)文件中定義了多個(gè)模塊的情況下）。
2. LOCAL_SRC_FILES：當(dāng)前模塊包含的所有源代碼文件。
3. LOCAL_MODULE：當(dāng)前模塊的名稱，這個(gè)名稱應(yīng)當(dāng)是唯一的，并且不能包含空格。模塊間的依賴關(guān)系就是通過這個(gè)名稱來引用的。
4. LOCAL_MODULE_CLASS：標(biāo)識(shí)所編譯模塊最后放置的位置。ETC表示放置在/system/etc.目錄下，APPS表示放置在/system/app目錄下，SHARED_LIBRARIES表示放置在/system/lib目錄下。如果具體指定，則編譯的模塊不會(huì)放到編譯系統(tǒng)中，最后會(huì)在out對(duì)應(yīng)product的obj目錄下的對(duì)應(yīng)目錄中。
5. LOCAL_SRC_FILES：這是要編譯的源代碼文件列表。只要列出要傳遞給編譯器的文件即可，編譯系統(tǒng)會(huì)自動(dòng)計(jì)算依賴關(guān)系。源代碼文件路徑都是相相對(duì)于LOCAL_PATH的，因此可以使用相對(duì)路徑進(jìn)行描述。
6. LOCAL_JAVA_LIBRARIES：當(dāng)前模塊依賴的Java共享庫(kù)，也叫Java動(dòng)態(tài)庫(kù)。例如framework.jar包。
7. LOCAL_STATIC_JAVA_LIBRARIES：當(dāng)前模塊依賴的Java靜態(tài)庫(kù)，在Android里，導(dǎo)入的jar包和引用的第三方工程都屬于Java靜態(tài)庫(kù)。
8. LOCAL_STATIC_LIBRARIES：當(dāng)前模塊在運(yùn)行時(shí)依賴的靜態(tài)庫(kù)的名稱。
9. LOCAL_SHARED_LIBRARIES：當(dāng)前模塊在運(yùn)行時(shí)依賴的動(dòng)態(tài)庫(kù)的名稱。
10. LOCAL_C_INCLUDES：c或c++語言需要的頭文件的路徑。
11. LOCAL_CFLAGS：提供給C/C++編譯器的額外編譯參數(shù)。
12. LOCAL_PACKAGE_NAME：當(dāng)前APK應(yīng)用的名稱。
13. LOCAL_CERTIFICATE：簽署當(dāng)前應(yīng)用的證書名稱。
14. LOCAL_MODULE_TAGS：當(dāng)前模塊所包含的標(biāo)簽，一個(gè)模塊可以包含多個(gè)標(biāo)簽。標(biāo)簽的值可能是eng、user、debug、development、optional。其中，optional是默認(rèn)標(biāo)簽。
15. LOCAL_DEX_PREOPT：apk的odex優(yōu)化開關(guān)，默認(rèn)是false。

除此之外，Build系統(tǒng)中還定義了一些函數(shù)方便在Android.mk中使用，包括：
1. $(call my-dir)：獲取當(dāng)前文件夾的路徑。
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輸入的目標(biāo)文件夾路徑。

您可能感興趣的文章: