詳解安卓系統(tǒng)中的Android.mk文件
概述
Android.mk文件用來向編譯系統(tǒng)描述如何編譯你的源代碼。更確切地說,該文件其實就是一個小型的Makefile。由于該文件會被NDK的編譯工具解析多次,因此應(yīng)該盡量減少源碼中聲明變量,因為這些變量可能會被多次定義從而影響到后面的解析。這個文件的語法允許把源代碼組織成模塊,每個模塊屬于下列類型之一:
APK程序:一般的Android程序,編譯打包生成apk文件。
JAVA庫:java類庫,編譯打包生成jar包文件。
C\C++應(yīng)用程序:可執(zhí)行的C/C++應(yīng)用程序。
C\C++靜態(tài)庫:編譯生產(chǎn)C/C++靜態(tài)庫,并打包成.a文件。
C\C++共享庫:編譯生成共享庫,并打包成.so文件,有且只有共享庫才能被安裝/復(fù)制到APK包中。
舉例
這里參考了網(wǎng)上一個通用的例子,編譯簡單的“Hello World”,來說明一下Android.mk編寫。例如下面的文件:
1. sources/test/hello.c
2. sources/test/Android.mk
其中“hello.c”是一個JNI共享庫,實現(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) : 一個Android.mk文件首先必須定義好LOCAL_PATH變量,用于在開發(fā)樹中查找源文件。在這個例子中,宏函數(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等)。這是非常有必要的,因為所有的編譯文件都在同一個GUN MKAE執(zhí)行環(huán)境中,所有的變量都是全局變量,不清除容易引起解析錯誤。
3. LOCAL_MODULE := hello:LOCAL_MODULE變量必須定義,用來標(biāo)識在Android.mk文件描述的每一個模塊。而且名稱必須是唯一的,并且不能包含空格。編譯系統(tǒng)會自動產(chǎn)生合適的前綴和后綴,比如一個被命名為hello的共享庫模塊,將會生成libhello.so文件。如果把庫命名為libhello,編譯系統(tǒng)將不會添加任何lib前綴,也會生成libhello.so文件。
4. LOCAL_SRC_FILES := hello.c:LOCAL_SRC_FILES變量必須包含將要編譯打包進(jìn)模塊中的源代碼文件。
5. include $(BUILD_SHARED_LIBRARY):BUILD_SHARED_LIBRARY是編譯系統(tǒng)提供的變量,指向一個GNU Makefile腳本(應(yīng)該就是build/core目錄下的shared_library.mk),負(fù)責(zé)收集自從上次調(diào)用include $(CLEAR_VARS)以來,定義在LOCAL_***變量中的所有信息,并且決定編譯什么,如何正確地去做,并根據(jù)其規(guī)則生成靜態(tài)庫。
6. 解釋一下Android.mk里變量定義字符":="?!?=”類似于c中的宏,即在定義處明確展開,完全進(jìn)行文本替換。
模塊描述變量
下面的變量用于向系統(tǒng)描述我們自己的模塊,它應(yīng)該定義在include $(CLEAR_VARS)和include $(BUILD_***)之間。正如前面講述的那樣,$(CLEAR_VARS)是一個腳本,清除所有這些變量,除非在描述中顯示注明。
1. LOCAL_PATH:這個變量用于給出當(dāng)前文件的路徑,必須在Android.mk的開頭定義,可以這樣使用:LOCAL_PATH := $(call my-dir),這樣這個變量不會被$(CLEAR_VARS)清除,因為每個Android.mk只需要定義一次(即使一個文件中定義了多個模塊的情況下)。
2. LOCAL_SRC_FILES:當(dāng)前模塊包含的所有源代碼文件。
3. LOCAL_MODULE:當(dāng)前模塊的名稱,這個名稱應(yīng)當(dāng)是唯一的,并且不能包含空格。模塊間的依賴關(guān)系就是通過這個名稱來引用的。
4. LOCAL_MODULE_CLASS:標(biāo)識所編譯模塊最后放置的位置。ETC表示放置在/system/etc.目錄下,APPS表示放置在/system/app目錄下,SHARED_LIBRARIES表示放置在/system/lib目錄下。如果具體指定,則編譯的模塊不會放到編譯系統(tǒng)中,最后會在out對應(yīng)product的obj目錄下的對應(yīng)目錄中。
5. LOCAL_SRC_FILES:這是要編譯的源代碼文件列表。只要列出要傳遞給編譯器的文件即可,編譯系統(tǒng)會自動計算依賴關(guān)系。源代碼文件路徑都是相相對于LOCAL_PATH的,因此可以使用相對路徑進(jìn)行描述。
6. LOCAL_JAVA_LIBRARIES:當(dāng)前模塊依賴的Java共享庫,也叫Java動態(tài)庫。例如framework.jar包。
7. LOCAL_STATIC_JAVA_LIBRARIES:當(dāng)前模塊依賴的Java靜態(tài)庫,在Android里,導(dǎo)入的jar包和引用的第三方工程都屬于Java靜態(tài)庫。
8. LOCAL_STATIC_LIBRARIES:當(dāng)前模塊在運行時依賴的靜態(tài)庫的名稱。
9. LOCAL_SHARED_LIBRARIES:當(dāng)前模塊在運行時依賴的動態(tài)庫的名稱。
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)簽,一個模塊可以包含多個標(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)文件夾路徑。
- 解決在eclipse中將android項目生成apk并且給apk簽名的實現(xiàn)方法詳解
- java導(dǎo)出csv方法實現(xiàn)講解
- java生成csv文件亂碼的解決方法示例 java導(dǎo)出csv亂碼
- unity3d發(fā)布apk在android虛擬機中運行的詳細(xì)步驟(unity3d導(dǎo)出android apk)
- Android APK使用Debug簽名重新打包 Eclipse更改默認(rèn)Debug簽名
- Java導(dǎo)出txt文件的方法
- Java數(shù)據(jù)導(dǎo)出功能之導(dǎo)出Excel文件實例
- java實現(xiàn)適用于安卓的文件下載線程類
- Eclipse下配置Ant腳本并自動打包帶簽名的Android apk
- Eclipse導(dǎo)出安卓apk文件的圖文教程
相關(guān)文章
C語言實現(xiàn)文件內(nèi)容按行隨機排列的算法示例
這篇文章主要介紹了C語言實現(xiàn)文件內(nèi)容按行隨機排列的算法,涉及C語言字符串、數(shù)組遍歷與隨機數(shù)相關(guān)算法實現(xiàn)技巧,需要的朋友可以參考下2017-09-09VC List Control控件如何刪除選中的記錄實例詳解
這篇文章主要介紹了VC List Control控件如何刪除選中的記錄實例詳解的相關(guān)資料,需要的朋友可以參考下2017-06-06C語言字符函數(shù)、內(nèi)存函數(shù)功能及實現(xiàn)代碼
這篇文章主要介紹了C語言字符函數(shù)、內(nèi)存函數(shù) 功能及實現(xiàn),本文給大家介紹的非常詳細(xì),對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2021-02-02C++類和對象深入探索之分文件編寫點和圓的關(guān)系詳解
先前把C++類和對象的封裝講完了,并且留下了一個判斷兩個立方體是否相等的案例,但是那么多知識點,僅僅一個案例是不夠的,所以再來一個分文件編寫點圓關(guān)系的案例;創(chuàng)建圓類和點類,圓類包含點類,算是一個嵌套吧,順便復(fù)習(xí)一下分文件編寫的方法,開整2022-05-05C語言數(shù)組應(yīng)用實現(xiàn)掃雷游戲
這篇文章主要為大家詳細(xì)介紹了C語言數(shù)組應(yīng)用實現(xiàn)掃雷游戲,文中示例代碼介紹的非常詳細(xì),具有一定的參考價值,感興趣的小伙伴們可以參考一下2022-06-06