Android.mk的用法和基礎

 一個Android.mk file用來向編譯系統描述你的源代碼。具體來說：該檔案是GNU Makefile的一小部分，會被編譯系統解析一次或多次。你可以在每一個Android.mk file中定義一個或多個子產品，你也可以在幾個子產品中使用同一個源代碼檔案。每個子產品屬下列類型之一：

  1）APK程式，一般的Android程式，編譯打包生成apk檔案

  2）JAVA庫，java類庫，編譯打包生成jar檔案

  3)  C\C++應用程式，可執行的C\C++應用程式

  4）C\C++靜态庫，編譯生成C\C++靜态庫，并打包成.a檔案

  5）C\C++共享庫， 編譯生成共享庫（動态連結庫），并打包成.so， 有且隻有共享庫才能被安裝/複制到您的應用軟體（APK）包中。

（1）先看一個簡單的例子：一個簡單的"hello world"，比如下面的檔案：

sources/helloworld/helloworld.c 

sources/helloworld/Android.mk

相應的Android.mk檔案會像下面這樣：

---------- cut here ------------------

LOCAL_PATH := $(call my-dir)  

include $(CLEAR_VARS)  

LOCAL_MODULE  

:= helloworld  

LOCAL_SRC_FILES := helloworld.c  

include $(BUILD_SHARED_LIBRARY)  

--------- cut here ------------------

      我們來解釋一下這幾行代碼：

1，LOCAL_PATH := $(call my-dir) ，一個Android.mk file首先必須定義好LOCAL_PATH變量。它用于在開發樹中查找源檔案。在這個例子中，宏函數‘my-dir’, 由編譯系統提供，用于傳回目前路徑（即包含Android.mk file檔案的目錄）。

2，include $( CLEAR_VARS)，CLEAR_VARS由編譯系統提供（(可以在 android 安裝目錄下的/build/core/config.mk 檔案看到其定義，為 CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk)），指定讓GNU MAKEFILE為你清除許多LOCAL_XXX變量（例如 LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES, 等等...),除LOCAL_PATH 。這是必要的，因為所有的編譯控制檔案都在同一個GNU MAKE執行環境中，所有的變量都是全局的。

3，LOCAL_MODULE := helloworld，LOCAL_MODULE變量必須定義，以辨別你在Android.mk檔案中描述的每個子產品。名稱必須是唯一的，而且不包含任何空格。注意編譯系統會自動産生合适的字首和字尾，換句話說，一個被命名為'foo'的共享庫子產品，将會生成'libfoo.so'檔案（也可以直接已libxxx命名好）。

4，LOCAL_SRC_FILES := helloworld.c，LOCAL_SRC_FILES變量必須包含将要編譯打包進子產品中的C或C++源代碼檔案。注意，你不用在這裡列出頭檔案和包含檔案，因為編譯系統将會自動為你找出依賴型的檔案；僅僅列出直接傳遞給編譯器的源代碼檔案就好。

       此處雖沒用到其他常用的還有：

5，LOCAL_C_INCLUDES：可選變量，表示頭檔案的搜尋路徑。預設的頭檔案的搜尋路徑是LOCAL_PATH目錄。示例：LOCAL_C_INCLUDES := sources/foo或LOCAL_C_INCLUDES := $(LOCAL_PATH)/../foo

6，TARGET_ARCH：目标 CPU平台的名字；TARGET_PLATFORM：Android.mk 解析的時候，目标 Android 平台的名字；TARGET_ARCH_ABI：暫時隻支援兩個 value，armeabi 和 armeabi-v7a

7，LOCAL_STATIC_LIBRARIES: 表示該子產品需要使用哪些靜态庫，以便在編譯時進行連結。

8，LOCAL_SHARED_LIBRARIES:  表示子產品在運作時要依賴的共享庫（動态庫），在連結時就需要，以便在生成檔案時嵌入其相應的資訊。

9，LOCAL_LDLIBS:  編譯子產品時要使用的附加的連結器選項。

10，LOCAL_ARM_MODE: 預設情況下， arm目标二進制會以 thumb 的形式生成(16 位)，你可以通過設定這個變量為 arm如果你希望你的 module 是以 32 位指令的形式

11，LOCAL_CFLAGS:  可選的編譯器選項，在編譯 C 代碼檔案的時候使用

12，include $(call all-subdir-makefiles)：傳回一個位于目前'my-dir'路徑的子目錄中的所有Android.mk的清單。

（2）在Android中增加本地程式或者庫，這些程式和庫與其所載路徑沒有任何關系，隻和它們的Android.mk檔案有關系。Android.mk和普通的Makefile有所不同，它具有統一的寫法，主要包含一些系統公共的宏。在一個Android.mk中可以生成多個可執行程式、動态庫和靜态庫。

A，編譯C/C++應用程式的模闆：

     #Test Exe

     LOCAL_PATH := $(call my-dir)

     #include $(CLEAR_VARS)

     LOCAL_SRC_FILES:= main.c

     LOCAL_MODULE:= test_exe

     #LOCAL_C_INCLUDES :=

     #LOCAL_STATIC_LIBRARIES :=

     #LOCAL_SHARED_LIBRARIES :=

     include $(BUILD_EXECUTABLE)

（菜鳥級别解釋：:=是指派的意思，+=是追加的意思，$是引用某變量的值）BUILD_EXECUTABLE表示以一個可執行程式的方式進行編譯。補充說明：include $(BUILD_PACKAGE)則是編譯出一個apk，include $(BUILD_STATIC_JAVA_LIBRARY)則是編譯出jar包。

B，編譯靜态庫的模闆：

     #Test Static Lib

     include $(CLEAR_VARS)

     LOCAL_SRC_FILES:= /

               helloworld.c

     LOCAL_MODULE:= libtest_static

     include $(BUILD_STATIC_LIBRARY)

一般的和上面相似，BUILD_STATIC_LIBRARY表示編譯一個靜态庫.a檔案。靜态庫不會複制到的APK包中，但是能夠用于編譯共享庫。

C，編譯動态庫的模闆：

     #Test Shared Lib

     LOCAL_MODULE:= libtest_shared

     TARGET_PRELINK_MODULES := false

      include $(BUILD_SHARED_LIBRARY)

一般的和上面相似，BUILD_SHARED_LIBRARY表示編譯一個動态庫。

      以上三者的生成結果分别在如下，generic依具體target會變：

out/target/product/generic/obj/EXECUTABLE

out/target/product/generic/obj/STATIC_LIBRARY

out/target/product/generic/obj/SHARED_LIBRARY

      每個子產品的目标檔案夾分别為：

可執行程式：XXX_intermediates

靜态庫：      XXX_static_intermediates

動态庫：      XXX_shared_intermediates

（3）另外，在Android.mk檔案中，還可以指定最後的目标安裝路徑，用LOCAL_MODULE_PATH和LOCAL_UNSTRIPPED_PATH來指定。不同的檔案系統路徑用以下的宏進行選擇：

TARGET_ROOT_OUT：表示根檔案系統out/target/product/generic/root。

TARGET_OUT：表示system檔案系統out/target/product/generic/system。

TARGET_OUT_DATA：表示data檔案系統out/target/product/generic/data。

OUT_DIR：代碼工程編譯時的out生成目錄

PRODUCT_OUT：映象生成目錄