android編譯系統的makefile檔案Android.mk寫法

轉載地址：http://www.cnblogs.com/hesiming/archive/2011/03/15/1984444.html

 

(1)Android.mk檔案首先需要指定LOCAL_PATH變數，用於尋找源檔案。由於一般情況下
Android.mk和需要編譯的源檔案在同一目錄下，所以定義成如下形式：
LOCAL_PATH:=$(call my-dir)
上面的語句的意思是將LOCAL_PATH變數定義成本檔案所在目錄路徑。

(2)Android.mk中可以定義多個編譯模組，每個編譯模組都是以include $(CLEAR_VARS)開始
以include $(BUILD_XXX)結束。
include $(CLEAR_VARS)
CLEAR_VARS由編譯系統提供，指定讓GNU MAKEFILE為你清除除LOCAL_PATH以外的所有LOCAL_XXX變數，
如LOCAL_MODULE，LOCAL_SRC_FILES，LOCAL_SHARED_LIBRARIES，LOCAL_STATIC_LIBRARIES等。
include $(BUILD_STATIC_LIBRARY)表示編譯成靜態庫
include $(BUILD_SHARED_LIBRARY)表示編譯成動態庫。
include $(BUILD_EXECUTABLE)表示編譯成可執行程式

(3)舉例如下(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) 模組三編譯成動態庫

(4)編譯一個應用程式(APK)
  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)

(5)編譯一個依賴於靜態Java庫(static.jar)的應用程式
  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)

(6)編譯一個需要用平台的key簽名的應用程式
  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)

(7)編譯一個需要用特定key前面的應用程式
  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)

(8)添加一個先行編譯應用程式
  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)

(9)添加一個靜態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)

(10)Android.mk的編譯模組中間可以定義相關的編譯內容，也就是指定相關的變數如下：
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