android的 makefile -- Android.mk 分析
首先我們來看看android裡makefile的寫法
(1)Android.mk檔案首先需要指定LOCAL_PATH變數，用於查詢原始檔,巨集函式’my-dir’, 由編譯系統提供。由於一般情況下Android.mk和需要編譯的原始檔在同一目錄下，所以定義成如下形式：
LOCAL_PATH:=$(call my-dir)
上面的語句的意思是 將LOCAL_PATH變數定義成 本檔案所在 目錄路徑。
一個 Android.mk中 可以 定義 多個編譯模組，每個編譯模組 都是 以include $(CLEAR_VARS)開始
以include $(BUILD_XXX)結束。
BUILD_PACKAGE 建立一個APK
include $(CLEAR_VARS)
CLEAR_VARS由編譯系統提供，指的是clear_vars.mk，指定讓GNU MAKEFILE為你 清除 除LOCAL_PATH以外 的所有LOCAL_XXX變數，
如LOCAL_MODULE，LOCAL_SRC_FILES，LOCAL_SHARED_LIBRARIES，LOCAL_STATIC_LIBRARIES等。
LOCAL_MODULE:=xxx
生成的模組的名稱(注意應用程式名稱用LOCAL_PACKAGE_NAME，而不是LOCAL_MODULE)，當 編譯 動態庫 或者 靜態庫 時，此變數 標示 庫名稱；
LOCAL_SRC_FILES
LOCAL_PACKAGE_NAME，package的名字，這個名字在指令碼中將標識這個app或package。
LOCAL_MODULE_TAGS := user eng tests optional
user: 指該模組只在user版本下才編譯
eng: 指該模組只在eng版本下才編譯
tests: 指該模組只在tests版本下才編譯
optional:指該模組在 所有版本下都編譯，預設是optional
LOCAL_CERTIFICATELOCAL_C_INCLUDES:=include 這個是用來指定在編譯時即將使用的c標頭檔案的位置，以當前目錄為起點。
include $(BUILD_STATIC_LIBRARY)表示編譯成靜態庫，字尾為.a。
include $(BUILD_SHARED_LIBRARY)表示編譯成動態庫，用來指示將當前模組編譯為共享庫，字首為lib，字尾為.so。
include $(BUILD_EXECUTABLE)表示編譯成可執行程式
（2）定義多個Android.mk檔案。
有的時候，需要編譯的模組比較多，我們可能會將對應的模組放置在相應的目錄中，這樣，我們可以在每個目錄中定義對應的Android.mk檔案（類似於上面的寫法），最後，在根目錄放置一個Android.mk檔案，內容如下：
include $(call all-subdir-makefiles)
只需要這一行就可以了，它的作用就是包含所有子目錄中的Android.mk檔案
另一種 方法就是可以在一個Android.mk檔案裡包含多個模組。
很直觀的想法就是將第一個Android.mk檔案的內容複製一份，然後修改。我最開始也是這樣做的，但是後來出現問題了，在第二個模組中的原始碼找不到，最後還是看文件，發現裡面已經有示例解釋了：
LOCAL_PATH := $(call my-dir)
大意是：在這個Android.mk裡面只需要呼叫一次$(call my-dir)就夠了，否則 會出錯，如果所有的原始檔都在一個目錄中。
如果需要的話，可以在第一次呼叫call my-dir的時候，將值儲存下來，比如：
MY_LOCAL_PATH := $(call my-dir)
LOCAL_PATH := $(MY_LOCAL_PATH)
然後，在另外一個模組中，繼續如下定義：
LOCAL_PATH := $(MY_LOCAL_PATH)
(3)簡單 例子1 ，編譯一個 普通apk
1 ifeq ($(BOARD_USE_DEFAULT_APPINSTALL),true) // 這一行 和 最後 一行 是 定義了 一個 開關 BOARD_USE_DEFAULT_APPINSTALL ，如果 這個 開關 為 true，那麼就 執行 這個 makefile，這個開關 定義在 我的專案 device/amlogic/xxx/BoardConfig.mk 裡， 如BOARD_USE_DEFAULT_APPINSTALL
:= false
2 LOCAL_PATH:= $(call my-dir) //LOCAL_PATH必須位於Android.mk檔案的最開始。它是用來定位原始檔的位置，$(call my-dir)的作用就是返回當前目錄的路徑。
3 include $(CLEAR_VARS) //作用是清除一些變數的值，但是LOCAL_PATH除外
4 LOCAL_MODULE_TAGS := optional //optional:指該模組在 所有版本下都編譯
5 LOCAL_SRC_FILES := $(call all-subdir-java-files) //用來指定參與編譯的原始碼檔案
6 LOCAL_PACKAGE_NAME := AppInstaller //package的名字
7 LOCAL_CERTIFICATE := platform //指定 使用的哪種key 來給apk簽名，platform 就是 指 用 platform.pk8和platform.x509.pem兩個檔案 來 簽名。用這兩個key簽名後apk才真正可以放入系統程序中；
8 include $(BUILD_PACKAGE) //建立一個APK
9 endif
-----------------------------------------------------
簡單 例子 2，把 c檔案 編譯 為 共享庫
一個簡單的"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 ------------------ 解釋：LOCAL_MODULE變數必須定義，以標識你在Android.mk檔案中描述的每個模組。名稱必須是唯一的，而且不包含任何空格。注意編譯系統會自動產生合適的字首和字尾，換句話說，一個被命名為'foo'的共享庫模組，將會生成'libfoo.so'檔案。
LOCAL_SRC_FILES變數必須包含將要編譯打包進模組中的C或C++原始碼檔案。注意，你不用在這裡列出標頭檔案和包含檔案，因為編譯系統將會自動為你找出依賴型的檔案；僅僅列出直接傳遞給編譯器的原始碼檔案就好。
====================================
舉例如下(frameworks/base/libs/audioflinger/Android.mk)：
- LOCAL_PATH:= $(call my-dir)
- include $(CLEAR_VARS) 模組一
- ifeq ($(AUDIO_POLICY_TEST),true)
- ENABLE_AUDIO_DUMP := true
- endif
- LOCAL_SRC_FILES:= \
- AudioHardwareGeneric.cpp \
- AudioHardwareStub.cpp \
- AudioHardwareInterface.cpp
- ifeq ($(ENABLE_AUDIO_DUMP),true)
- LOCAL_SRC_FILES += AudioDumpInterface.cpp
- LOCAL_CFLAGS += -DENABLE_AUDIO_DUMP
- endif
- LOCAL_SHARED_LIBRARIES := \
- libcutils \
- libutils \
- libbinder \
- libmedia \
- libhardware_legacy
- ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
- LOCAL_CFLAGS += -DGENERIC_AUDIO
- endif
- LOCAL_MODULE:= libaudiointerface
- ifeq ($(BOARD_HAVE_BLUETOOTH),true)
- LOCAL_SRC_FILES += A2dpAudioInterface.cpp
- LOCAL_SHARED_LIBRARIES += liba2dp
- LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
- LOCAL_C_INCLUDES += $(call include-path-for, bluez)
- endif
- include $(BUILD_STATIC_LIBRARY) 模組一編譯成靜態庫
- include $(CLEAR_VARS) 模組二
- LOCAL_SRC_FILES:= \
- AudioPolicyManagerBase.cpp
- LOCAL_SHARED_LIBRARIES := \
- libcutils \
- libutils \
- libmedia
- ifeq ($(TARGET_SIMULATOR),true)
- LOCAL_LDLIBS += -ldl
- else
- LOCAL_SHARED_LIBRARIES += libdl
- endif
- LOCAL_MODULE:= libaudiopolicybase
- ifeq ($(BOARD_HAVE_BLUETOOTH),true)
- LOCAL_CFLAGS += -DWITH_A2DP
- endif
- ifeq ($(AUDIO_POLICY_TEST),true)
- LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
- endif
- include $(BUILD_STATIC_LIBRARY) 模組二編譯成靜態庫
- include $(CLEAR_VARS) 模組三
- LOCAL_SRC_FILES:= \
- AudioFlinger.cpp \
- AudioMixer.cpp.arm \
- AudioResampler.cpp.arm \
- AudioResamplerSinc.cpp.arm \
- AudioResamplerCubic.cpp.arm \
- AudioPolicyService.cpp
- LOCAL_SHARED_LIBRARIES := \
- libcutils \
- libutils \
- libbinder \
- libmedia \
- libhardware_legacy
- ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
- LOCAL_STATIC_LIBRARIES += libaudiointerface libaudiopolicybase
- LOCAL_CFLAGS += -DGENERIC_AUDIO
- else
- LOCAL_SHARED_LIBRARIES += libaudio libaudiopolicy
- endif
- ifeq ($(TARGET_SIMULATOR),true)
- LOCAL_LDLIBS += -ldl
- else
- LOCAL_SHARED_LIBRARIES += libdl
- endif
- LOCAL_MODULE:= libaudioflinger
- ifeq ($(BOARD_HAVE_BLUETOOTH),true)
- LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
- LOCAL_SHARED_LIBRARIES += liba2dp
- endif
- ifeq ($(AUDIO_POLICY_TEST),true)
- LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
- endif
- ifeq ($(TARGET_SIMULATOR),true)
- ifeq ($(HOST_OS),linux)
- LOCAL_LDLIBS += -lrt -lpthread
- endif
- endif
- ifeq ($(BOARD_USE_LVMX),true)
- LOCAL_CFLAGS += -DLVMX
- LOCAL_C_INCLUDES += vendor/nxp
- LOCAL_STATIC_LIBRARIES += liblifevibes
- LOCAL_SHARED_LIBRARIES += liblvmxservice
- # LOCAL_SHARED_LIBRARIES += liblvmxipc
- endif
- include $(BUILD_SHARED_LIBRARY) 模組三編譯成動態庫
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- # Build all java files in the java subdirectory-->直譯（建立在java子目錄中的所有Java檔案）
- LOCAL_SRC_FILES := $(call all-subdir-java-files)
- # Name of the APK to build-->直譯（建立APK的名稱）
- LOCAL_PACKAGE_NAME := LocalPackage
- # Tell it to build an APK-->直譯（告訴它來建立一個APK）
- include $(BUILD_PACKAGE)
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- # List of static libraries to include in the package
- LOCAL_STATIC_JAVA_LIBRARIES := static-library
- # Build all java files in the java subdirectory
- LOCAL_SRC_FILES := $(call all-subdir-java-files)
- # Name of the APK to build
- LOCAL_PACKAGE_NAME := LocalPackage
- # Tell it to build an APK
- include $(BUILD_PACKAGE)
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- # Build all java files in the java subdirectory
- LOCAL_SRC_FILES := $(call all-subdir-java-files)
- # Name of the APK to build
- LOCAL_PACKAGE_NAME := LocalPackage
- LOCAL_CERTIFICATE := platform
- # Tell it to build an APK
- include $(BUILD_PACKAGE)
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- # Build all java files in the java subdirectory
- LOCAL_SRC_FILES := $(call all-subdir-java-files)
- # Name of the APK to build
- LOCAL_PACKAGE_NAME := LocalPackage
- LOCAL_CERTIFICATE := vendor/example/certs/app
- # Tell it to build an APK
- include $(BUILD_PACKAGE)
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- # Module name should match apk name to be installed.
- LOCAL_MODULE := LocalModuleName
- LOCAL_SRC_FILES := $(LOCAL_MODULE).apk
- LOCAL_MODULE_CLASS := APPS
- LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
- include $(BUILD_PREBUILT)
- 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)
LOCAL_AAPT_FLAGS
LOCAL_ACP_UNAVAILABLE
LOCAL_ADDITIONAL_JAVA_DIR
LOCAL_AIDL_INCLUDES
LOCAL_ALLOW_UNDEFINED_SYMBOLS
LOCAL_ARM_MODE
LOCAL_ASFLAGS
LOCAL_ASSET_DIR
LOCAL_ASSET_FILES 在Android.mk檔案中編譯應用程式(BUILD_PACKAGE)時設定此變數，表示資原始檔，
通常會定義成LOCAL_ASSET_FILES += $(call find-subdir-assets)
LOCAL_BUILT_MODULE_STEM
LOCAL_C_INCLUDES 額外的C/C++編譯標頭檔案路徑，用LOCAL_PATH表示本檔案所在目錄
舉例如下：
LOCAL_C_INCLUDES += extlibs/zlib-1.2.3
LOCAL_C_INCLUDES += $(LOCAL_PATH)/src
LOCAL_CC 指定C編譯器
LOCAL_CERTIFICATE 簽名認證
LOCAL_CFLAGS 為C/C++編譯器定義額外的標誌(如巨集定義)，舉例：LOCAL_CFLAGS += -DLIBUTILS_NATIVE=1
LOCAL_CLASSPATH
LOCAL_COMPRESS_MODULE_SYMBOLS
LOCAL_COPY_HEADERS install應用程式時需要複製的標頭檔案，必須同時定義LOCAL_COPY_HEADERS_TO
LOCAL_COPY_HEADERS_TO install應用程式時複製標頭檔案的目的路徑
LOCAL_CPP_EXTENSION 如果你的C++檔案不是以cpp為檔案字尾，你可以通過LOCAL_CPP_EXTENSION指定C++檔案字尾名
如：LOCAL_CPP_EXTENSION := .cc
注意統一模組中C++檔案字尾必須保持一致。
LOCAL_CPPFLAGS 傳遞額外的標誌給C++編譯器，如：LOCAL_CPPFLAGS += -ffriend-injection
LOCAL_CXX 指定C++編譯器
LOCAL_DX_FLAGS
LOCAL_EXPORT_PACKAGE_RESOURCES
LOCAL_FORCE_STATIC_EXECUTABLE 如果編譯的可執行程式要進行靜態連結(執行時不依賴於任何動態庫)，則設定LOCAL_FORCE_STATIC_EXECUTABLE:=true
目前只有libc有靜態庫形式，這個只有檔案系統中/sbin目錄下的應用程式會用到，這個目錄下的應用程式在執行時通常
檔案系統的其它部分還沒有載入，所以必須進行靜態連結。
LOCAL_GENERATED_SOURCES
LOCAL_INSTRUMENTATION_FOR
LOCAL_INSTRUMENTATION_FOR_PACKAGE_NAME
LOCAL_INTERMEDIATE_SOURCES
LOCAL_INTERMEDIATE_TARGETS
LOCAL_IS_HOST_MODULE
LOCAL_JAR_MANIFEST
LOCAL_JARJAR_RULES
LOCAL_JAVA_LIBRARIES 編譯java應用程式和庫的時候指定包含的java類庫，目前有core和framework兩種
多數情況下定義成：LOCAL_JAVA_LIBRARIES := core framework
注意LOCAL_JAVA_LIBRARIES不是必須的，而且編譯APK時不允許定義(系統會自動新增)
LOCAL_JAVA_RESOURCE_DIRS
LOCAL_JAVA_RESOURCE_FILES
LOCAL_JNI_SHARED_LIBRARIES
LOCAL_LDFLAGS 傳遞額外的引數給聯結器(務必注意引數的順序)
LOCAL_LDLIBS 為可執行程式或者庫的編譯指定額外的庫，指定庫以"-lxxx"格式，舉例：
LOCAL_LDLIBS += -lcurses -lpthread
LOCAL_LDLIBS += -Wl,-z,origin
LOCAL_MODULE 生成的模組的名稱(注意應用程式名稱用LOCAL_PACKAGE_NAME而不是LOCAL_MODULE)
LOCAL_MODULE_PATH 生成模組的路徑
LOCAL_MODULE_STEM
LOCAL_MODULE_TAGS 生成模組的標記
LOCAL_NO_DEFAULT_COMPILER_FLAGS
LOCAL_NO_EMMA_COMPILE
LOCAL_NO_EMMA_INSTRUMENT
LOCAL_NO_STANDARD_LIBRARIES
LOCAL_OVERRIDES_PACKAGES
LOCAL_PACKAGE_NAME //APK應用程式的名稱
LOCAL_POST_PROCESS_COMMAND
LOCAL_PREBUILT_EXECUTABLES 預編譯including $(BUILD_PREBUILT)或者$(BUILD_HOST_PREBUILT)時所用,指定需要複製的可執行檔案
LOCAL_PREBUILT_JAVA_LIBRARIES
LOCAL_PREBUILT_LIBS 預編譯including $(BUILD_PREBUILT)或者$(BUILD_HOST_PREBUILT)時所用, 指定需要複製的庫.
LOCAL_PREBUILT_OBJ_FILES
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES
LOCAL_PRELINK_MODULE 是否需要預連線處理(預設需要，用來做動態庫優化)
LOCAL_REQUIRED_MODULES 指定模組執行所依賴的模組(模組安裝時將會同步安裝它所依賴的模組)
LOCAL_RESOURCE_DIR
LOCAL_SDK_VERSION
LOCAL_SHARED_LIBRARIES 可連結動態庫
LOCAL_SRC_FILES 編譯原始檔
LOCAL_STATIC_JAVA_LIBRARIES
LOCAL_STATIC_LIBRARIES 可連結靜態庫
LOCAL_UNINSTALLABLE_MODULE
LOCAL_UNSTRIPPED_PATH
LOCAL_WHOLE_STATIC_LIBRARIES 指定模組所需要載入的完整靜態庫(這些精通庫在連結是不允許連結器刪除其中無用的程式碼)
LOCAL_YACCFLAGS
OVERRIDE_BUILT_MODULE_PATH
==========================================
android 最頂層的目錄 結構 如下：接下來我們詳細看一下android裡的makefile檔案
|-- Makefile （全域性的Makefile）
|-- bionic （Bionic含義為仿生，這裡面是一些基礎的庫的原始碼）
|-- bootloader （引導載入器）
|-- build （build目錄中的內容不是目標所用的程式碼，而是編譯和配置所需要的指令碼和工具）
|-- dalvik （JAVA虛擬機器）
|-- development （程式開發所需要的模板和工具）
|-- external （目標機器使用的一些庫）
|-- frameworks （應用程式的框架層）
|-- hardware （與硬體相關的庫）
|-- kernel （Linux2.6的原始碼）
|-- packages （Android的各種應用程式）
|-- prebuilt （Android在各種平臺下編譯的預置指令碼）
|-- recovery （與目標的恢復功能相關）
`-- system （Android的底層的一些庫）
-----------------------------------------------------------Makefile的規則如下：
target ... : prerequisites ...
command ... ...
target可以是一個 目標檔案，也可以是Object File（例如helloworld.obj），也可以是 執行檔案 和 標籤。
prerequisites就是生成target所需要的檔案或是目標。
command
也就是要達到target這個目標所需要執行的命令。這裡沒有說“使用生成target所需要執行的命令”，是因為target可能是標籤。需要注意的是
command前面必須是TAB鍵，而不是空格，因此喜歡在編輯器裡面將TAB鍵用空格替換的人需要特別小心了。
我們寫程式一般喜歡寫helloworld，當我們寫了一個c的helloworld之後，我們該如何寫helloworld來編譯helloworld.c呢？
下面就是編譯helloworld的makefile。
helloworld : helloworld.o
cc -o helloworld helloworld .o
helloworld.o : helloworld.c
cc -c main.c
clean:
rm helloworld helloworl.o
之後我們執行make就可以編譯helloworld.c了，執行make clean就可以清除編譯結果了（其實就是刪除helloworld helloworl.o）。
可能有人問為什麼執行make就會生成helloworld呢？這得從make的 預設處理 說起：make將makefile的第一個target作為作為最終的
target，凡是這個規則依賴的規則都將被執行，否則就不會執行。所以在執行make的時候，clean這個規則就沒有被執行。