程式師世界 >> 編程語言 >> C語言 >> C++ >> 關於C++ >> 詳解安卓體系中的Android.mk文件

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

編輯：關於C++

詳解安卓體系中的Android.mk文件。本站提示廣大學習愛好者：（詳解安卓體系中的Android.mk文件）文章只能為提供參考，不一定能成為您想要的結果。以下是詳解安卓體系中的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文件內容以下：

  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輸出的目的文件夾途徑。