Android.mk解析

1. Android.mk示例

LOCAL_PATH := $(call my-dir)             #指定目前目錄  include $(CLEAR_VARS)                    # 清除一些變量的值，但是LOCAL_PATH除外 LOCAL_MODULE_TAGS := optional            #編譯選項便是在何種情況下編譯  LOCAL_SRC_FILES := hello.c               #源檔案（可以指定多個）   LOCAL_MODULE := hello                    #編譯出來的子產品名  LOCAL_MODULE_CLASS := EXECUTABLES        #指定編譯之後放置的位置（此處訓示放在system/bin下）  include $(BUILD_XXX)              #引入編譯規則  

BUILD_EXECUTABLE	編譯成可執行的子產品	build/core/host_executable.mk
BUILD_STATIC_LIBRARY	編譯成靜态庫	字首為lib，字尾為.a	build/core/host_static_library.mk
BUILD_SHARED_LIBRARY	編譯成動态庫	字首為lib，字尾為.so	build/core/host_shared_library.mk

靜态庫不會複制到的APK包中，但是能夠用于編譯共享庫，生成一個名為 lib$(LOCAL_MODULE).a 的檔案

2. 常用子產品描述變量：

• LOCAL_PATH：給出目前檔案路徑，必須在Android.mk開頭定義，可以這樣使用：LOCAL_PATH := $(call my-dir)  這個變量不會被$(CLEAR_VARS)清除，是以每個 Android.mk 隻需要定義一次(即使在一個檔案中定義了幾個子產品的情況下)。
• LOCAL_SRC_FILES：要編譯的源碼檔案清單，編譯系統自動計算依賴，注意檔案名稱相對對LOCAL_PATH計算；檔案之間使用空格或者tab鍵分隔開，換行使用 / ，另外可以使用LOCAL_SRC_FILES := $(call all-subdir-java-files)包含所有java檔案
• LOCAL_MODULE：子產品名字，必須唯一，不能包含空格，必須在$(BUILD_XXX)之前定義，子產品名字決定了生成檔案的名字。
• LOCAL_STATIC_LIBRARIES: 表示該子產品需要使用哪些靜态庫，以便在編譯時進行連結。 
• LOCAL_SHARED_LIBRARIES:  表示子產品在運作時要依賴的共享庫（動态庫），在連結時就需要，以便在生成檔案時嵌入其相應的資訊，不需要添加.so字尾。
• LOCAL_JAVA_LIBRARIES：編譯java應用程式和庫的時候指定包含的java類庫，目前有core和framework兩種情況下定義成，LOCAL_JAVA_LIBRARIES := core framework，非必須
• LOCAL_MODULE_TAGS：子產品标記，一般的取值範圍為debug、eng、test、optional，如果不定義則預設為optional。對這幾個模式的解釋為：user：指該子產品隻在user版本下才編譯；eng：指該子產品隻在eng版本下才編譯；tests：指該子產品隻在tests版本下才編譯；optional：指該子產品在所有版本下都編譯。
• LOCAL_CFLAGS：編譯C代碼有用，附件包含路徑，宏定義或者編譯選項，為C，C++編譯器定義額外的标志，如：LOCAL_CFLAGS += -DLIBUTILS_NATIVE=1
• LOCAL_MODULE_PATH：（prebuilt）指定最後的目标安裝路徑，預設等于TARGET_OUT_$(LOCAL_MODULE_CLASS)，當然也可以手動指定，如$(TARGET_OUT_ETC)/permissions，等于要安裝在system/etc /permissions目錄。
• • TARGET_ROOT_OUT：表示根檔案系統。  
  • TARGET_OUT：表示 system檔案系統。  
  • TARGET_OUT_DATA：表示 data檔案系統。  
  • 用法如：LOCAL_MODULE_PATH :=$(TARGET_ROOT_OUT) 
• LOCAL_MODULE_CLASS：（prebuilt）辨別了所編譯子產品最後放置的位置，如果不指定，不會放到系統中。

• LOCAL_MODULE_CLASS := ETC	放于system/etc目錄
  LOCAL_MODULE_CLASS := EXECUTABLES	放于/system/bin目錄
  LOCAL_MODULE_CLASS := SHARED_LIBRARIES	放在/system/lib目錄
  LOCAL_MODULE_CLASS := JAVA_LIBRARIES
  LOCAL_MODULE_CLASS := STATIC_LIBRARIES
  LOCAL_MODULE_CLASS := APPS	放在/system/app目錄

• 可選項
• LOCAL_C_INCLUDES：可選變量，表示頭檔案的檢索路徑，預設是LOCAL_PATH，該選項要在LOCAL_CFLAGS/LOCAL_CPPFLAGS标志之前進行設定。
• LOCAL_CPP_EXTENSION：可選變量，指定C++代碼檔案的擴充名。
• LOCAL_CXXFLAGS：類似以上，針對C++源檔案
• LOCAL_CPPFLAGS：類似以上，對C和C++都适用
• LOCAL_PACKAGE_NAME：app的名字，例如Contacts
• LOCAL_PREBUILT_EXECUTABLES：（prebuilt）預編譯including $(BUILD_PREBUILT)或 $(BUILD_HOST_PREBUILT)時所用,指定需要複制的可執行檔案。
• LOCAL_PREBUILT_LIBS：（prebuilt）是在預編譯including $(BUILD_PREBUILT)或者$(BUILD_HOST_PREBUILT)時所用, 指定需要複制的庫。
• LOCAL_OVERRIDES_PACKAGES：此變量可以使其他的子產品不加入編譯，如源碼中DeskClock的android.mk有LOCAL_OVERRIDES_PACKAGES := AlarmClock，可以使 AlarmClock不會加入到編譯系統中，不會生成 AlarmClock.apk。
• LOCAL_MODULE_STEM：編譯中間檔案和target的名字，如果不指定，則使用LOCAL_MODULE。
• LOCAL_MODULE_SUFFIX：編譯目标檔案的字尾，預設Android自動添加。

• COMMON_PACKAGE_SUFFIX	.zip
  COMMON_JAVA_PACKAGE_SUFFIX	.jar
  COMMON_ANDROID_PACKAGE_SUFFIX	.apk

3. 編譯宏指令：使用$(call command)方式來調用

• my-dir：傳回目前Android.mk檔案所在的目錄路徑， 一般在Android.mk的開頭定義LOCAL_PATH
• all-subdir-makefiles：傳回一個目前my-dir路徑子目錄中所有Android.mk清單
• this-makefile：傳回目前makefile的路徑，即這個函數調用的地方
• parent-makefile：傳回調用樹中父makefile的路徑，即包含目前makefile的makefile的路徑
• inherit-product：加載其他的prebuilt.mk

Android.mk可以用于生成APK應用程式，JAVA庫，C，C++可執行程式，以及對應的動态庫和靜态庫

4. 一些有用的編譯模闆

• 編譯apk

          LOCAL_PATH := $(call my-dir)           include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := optional LOCAL_STATIC_JAVA_LIBRARIES := gson2.2 aquery v3dcore asupport socketio LOCAL_SRC_FILES := $(call all-java-files-under, src) \                    src/com/letv/t2/launcher/aidl/service/LiveLayerStatusBinderInterface.aidl \                    src/com/letv/t2/launcher/aidl/service/BarrageObserver.aidl \ # Add overlay folder. LOCAL_PACKAGE_OVERLAYS := overlay LOCAL_PACKAGE_NAME := T2Launcher LOCAL_CERTIFICATE := platform ifeq ($(findstring full_mstarnapoli,$(TARGET_PRODUCT)),full_mstarnapoli)     LOCAL_JAVA_LIBRARIES := com.mstar.android endif include $(CLEAR_VARS) LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := gson2.2:libs/gson-2.2.2.jar LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += aquery:libs/android-query.0.24.3.jar LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += v3dcore:libs/V3DCore.jar LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += asupport:libs/android-support-v4.jar LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += socketio:libs/android-websockets.jar include $(BUILD_MULTI_PREBUILT) include $(BUILD_PACKAGE)

• 編譯JAVA庫模闆

LOCAL_PATH := $(call my-dir)   include $(CLEAR_VARS)   # Build all java files in the java subdirectory   LOCAL_SRC_FILES := $(call all-subdir-java-files)   # Any libraries that this library depends on   LOCAL_JAVA_LIBRARIES := android.test.runner   # The name of the jar file to create   LOCAL_MODULE := sample   # Build a static jar file.   include $(BUILD_STATIC_JAVA_LIBRARY)  

• 編譯C，C++應用程式

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)  

• 編譯C，C++靜态庫

LOCAL_PATH := $(call my-dir)   include $(CLEAR_VARS)   LOCAL_SRC_FILES :=   helloworld.c   LOCAL_MODULE:= libtest_static   #LOCAL_C_INCLUDES :=   #LOCAL_STATIC_LIBRARIES :=   #LOCAL_SHARED_LIBRARIES :=   include $(BUILD_STATIC_LIBRARY)  

• 編譯C，C++動态庫

LOCAL_PATH := $(call my-dir)   include $(CLEAR_VARS)   LOCAL_SRC_FILES := helloworld.c   LOCAL_MODULE := libtest_shared   TARGET_PRELINK_MODULES := false   #LOCAL_C_INCLUDES :=   #LOCAL_STATIC_LIBRARIES :=   #LOCAL_SHARED_LIBRARIES :=   include $(BUILD_SHARED_LIBRARY)  

生成結果的目錄：

1）out/target/product/generic/obj/APPS   2）out/target/product/generic/obj/JAVA_LIBRARIES   3）out/target/product/generic/obj/EXECUTABLE   4）out/target/product/generic/obj/STATIC_LIBRARY   5）out/target/product/generic/obj/SHARED_LIBRARY 

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

1）APK程式：XXX_intermediates  2）JAVA庫程式：XXX_intermediates  這裡的XXX  3）CC++可執行程式：XXX_intermediates  4）CC++靜态庫： XXX_static_intermediates  5）CC++動态庫： XXX_shared_intermediates

參考連結： http://www.bdqn.cn/news/201307/10450.shtml

5. 加載第三方應用和類庫

• 內建靜态庫

LOCAL_PATH := $(call my-dir)  include $(CLEAR_VARS)  LOCAL_PREBUILT_LIBS := libA.a libB.a           LOCAL_STATIC_LIBRARIES := libA libB   include $(BUILD_MULTI_PREBUILT)

• 內建動态庫

LOCAL_PATH := $(call my-dir)  include $(CLEAR_VARS)  LOCAL_MODULE := liblinkshell LOCAL_MODULE_TAGS := optional LOCAL_MODULE_CLASS := SHARED_LIBRARIES LOCAL_CERTIFICATE := platform LOCAL_MODULE_SUFFIX := .so LOCAL_SRC_FILES := xxx.so include $(BUILD_PREBUILT) 

• 內建可執行檔案

LOCAL_PATH := $(call my-dir)  include $(CLEAR_VARS)  LOCAL_SRC_FILES := hellovprc.elf  LOCAL_MODULE := hellovprc.elf  LOCAL_MODULE_CLASS := EXECUTABLES //LOCAL_MODULE_PATH := $(TARGET_OUT)/bin    LOCAL_MODULE_TAGS := debug include $(BUILD_PREBUILT)  

• 內建prebuild應用程式apk

     方法一：建立目錄結構，如：

vendor/BM/APPs/MobileQQ2011/MobileQQ2011.apk vendor/BM/APPs/MobileQQ2011/Android.mk LOCAL_PATH := $(call my-dir)  include $(CLEAR_VARS)  # Module name should match apk name to be installed. LOCAL_MODULE := MobileQQ2011 LOCAL_MODULE_TAGS := optional LOCAL_MODULE_CLASS := APPS LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX) LOCAL_SRC_FILES := $(LOCAL_MODULE).apk LOCAL_CERTIFICATE := platform include $(BUILD_PREBUILT)

     方法二：純粹拷貝apk檔案

vendor/BM/APPs/MobileQQ2011.apk vendor/BM/APPs/Renren_Android_3.0.2.apk 通過android提供的PRODUCT_COPY_FILES這個變量來自動拷貝，隻需要給此變量指派。在任何一個确定加入編譯的mk檔案中加入 PRODUCT_COPY_FILES += / vendor/bm/APPS/MobileQQ2011. apk:system/app/MobileQQ2011.apk/ vendor/bm/APPS/Renren_Android_3.0.2. apk:system/app/Renren_Android_3.0.2.apk

6. 參考文檔：

http://blog.csdn.net/poolwater/article/details/10491061