2015年4月16日 星期四

[轉] Android MK 文件寫法

(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)
  1. LOCAL_PATH:= $(call my-dir)
  2. include $(CLEAR_VARS) 模塊一
  3. ifeq ($(AUDIO_POLICY_TEST),true)
  4. ENABLE_AUDIO_DUMP := true
  5. endif
  6. LOCAL_SRC_FILES:= \
  7. AudioHardwareGeneric.cpp \
  8. AudioHardwareStub.cpp \
  9. AudioHardwareInterface.cpp
  10. ifeq ($(ENABLE_AUDIO_DUMP),true)
  11. LOCAL_SRC_FILES += AudioDumpInterface.cpp
  12. LOCAL_CFLAGS += -DENABLE_AUDIO_DUMP
  13. endif
  14. LOCAL_SHARED_LIBRARIES := \
  15. libcutils \
  16. libutils \
  17. libbinder \
  18. libmedia \
  19. libhardware_legacy
  20. ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
  21. LOCAL_CFLAGS += -DGENERIC_AUDIO
  22. endif
  23. LOCAL_MODULE:= libaudiointerface
  24. ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  25. LOCAL_SRC_FILES += A2dpAudioInterface.cpp
  26. LOCAL_SHARED_LIBRARIES += liba2dp
  27. LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
  28. LOCAL_C_INCLUDES += $(call include-path-for, bluez)
  29. endif
  30. include $(BUILD_STATIC_LIBRARY) 模塊一編譯成靜態庫
  31. include $(CLEAR_VARS) 模塊二
  32. LOCAL_SRC_FILES:= \
  33. AudioPolicyManagerBase.cpp
  34. LOCAL_SHARED_LIBRARIES := \
  35. libcutils \
  36. libutils \
  37. libmedia
  38. ifeq ($(TARGET_SIMULATOR),true)
  39. LOCAL_LDLIBS += -ldl
  40. else
  41. LOCAL_SHARED_LIBRARIES += libdl
  42. endif
  43. LOCAL_MODULE:= libaudiopolicybase
  44. ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  45. LOCAL_CFLAGS += -DWITH_A2DP
  46. endif
  47. ifeq ($(AUDIO_POLICY_TEST),true)
  48. LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
  49. endif
  50. include $(BUILD_STATIC_LIBRARY) 模塊二編譯成靜態庫
  51. include $(CLEAR_VARS) 模塊三
  52. LOCAL_SRC_FILES:= \
  53. AudioFlinger.cpp \
  54. AudioMixer.cpp.arm \
  55. AudioResampler.cpp.arm \
  56. AudioResamplerSinc.cpp.arm \
  57. AudioResamplerCubic.cpp.arm \
  58. AudioPolicyService.cpp
  59. LOCAL_SHARED_LIBRARIES := \
  60. libcutils \
  61. libutils \
  62. libbinder \
  63. libmedia \
  64. libhardware_legacy
  65. ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
  66. LOCAL_STATIC_LIBRARIES += libaudiointerface libaudiopolicybase
  67. LOCAL_CFLAGS += -DGENERIC_AUDIO
  68. else
  69. LOCAL_SHARED_LIBRARIES += libaudio libaudiopolicy
  70. endif
  71. ifeq ($(TARGET_SIMULATOR),true)
  72. LOCAL_LDLIBS += -ldl
  73. else
  74. LOCAL_SHARED_LIBRARIES += libdl
  75. endif
  76. LOCAL_MODULE:= libaudioflinger
  77. ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  78. LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
  79. LOCAL_SHARED_LIBRARIES += liba2dp
  80. endif
  81. ifeq ($(AUDIO_POLICY_TEST),true)
  82. LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
  83. endif
  84. ifeq ($(TARGET_SIMULATOR),true)
  85. ifeq ($(HOST_OS),linux)
  86. LOCAL_LDLIBS += -lrt -lpthread
  87. endif
  88. endif
  89. ifeq ($(BOARD_USE_LVMX),true)
  90. LOCAL_CFLAGS += -DLVMX
  91. LOCAL_C_INCLUDES += vendor/nxp
  92. LOCAL_STATIC_LIBRARIES += liblifevibes
  93. LOCAL_SHARED_LIBRARIES += liblvmxservice
  94. # LOCAL_SHARED_LIBRARIES += liblvmxipc
  95. endif
  96. include $(BUILD_SHARED_LIBRARY) 模塊三編譯成動態庫
(4)編譯一個APK 
  1. LOCAL_PATH := $(call my-dir)
  2. include $(CLEAR_VARS)
  3. # Build all java files in the java subdirectory-->直譯(建立在java子目錄中的所有Java文件)
  4. LOCAL_SRC_FILES := $(call all-subdir-java-files)
  5. # Name of the APK to build-->直譯(創建APK的名稱
  6. LOCAL_PACKAGE_NAME := LocalPackage
  7. # Tell it to build an APK-->直譯(告訴它來建立一個APK)
  8. include $(BUILD_PACKAGE)

(5)編譯一個依賴於靜態Java庫(static.jar)的應用程式
  1. LOCAL_PATH := $(call my-dir)
  2. include $(CLEAR_VARS)
  3. # List of static libraries to include in the package
  4. LOCAL_STATIC_JAVA_LIBRARIES := static-library
  5. # Build all java files in the java subdirectory
  6. LOCAL_SRC_FILES := $(call all-subdir-java-files)
  7. # Name of the APK to build
  8. LOCAL_PACKAGE_NAME := LocalPackage
  9. # Tell it to build an APK
  10. include $(BUILD_PACKAGE)
(6)編譯一個需要用平台的key簽名的應用程式
  1. LOCAL_PATH := $(call my-dir)
  2. include $(CLEAR_VARS)
  3. # Build all java files in the java subdirectory
  4. LOCAL_SRC_FILES := $(call all-subdir-java-files)
  5. # Name of the APK to build
  6. LOCAL_PACKAGE_NAME := LocalPackage
  7. LOCAL_CERTIFICATE := platform
  8. # Tell it to build an APK
  9. include $(BUILD_PACKAGE)
(7)編譯一個需要用特定key前面的應用程式 
  1. LOCAL_PATH := $(call my-dir)
  2. include $(CLEAR_VARS)
  3. # Build all java files in the java subdirectory
  4. LOCAL_SRC_FILES := $(call all-subdir-java-files)
  5. # Name of the APK to build
  6. LOCAL_PACKAGE_NAME := LocalPackage
  7. LOCAL_CERTIFICATE := vendor/example/certs/app
  8. # Tell it to build an APK
  9. include $(BUILD_PACKAGE)
(8)添加一個預編譯應用程式
  1. LOCAL_PATH := $(call my-dir)
  2. include $(CLEAR_VARS)
  3. # Module name should match apk name to be installed.
  4. LOCAL_MODULE := LocalModuleName
  5. LOCAL_SRC_FILES := $(LOCAL_MODULE).apk
  6. LOCAL_MODULE_CLASS := APPS
  7. LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
  8. include $(BUILD_PREBUILT) 
(9)添加一個靜態JAVA庫
  1. LOCAL_PATH := $(call my-dir)
  2. include $(CLEAR_VARS)
  3. # Build all java files in the java subdirectory
  4. LOCAL_SRC_FILES := $(call all-subdir-java-files)
  5. # Any libraries that this library depends on
  6. LOCAL_JAVA_LIBRARIES := android.test.runner
  7. # The name of the jar file to create
  8. LOCAL_MODULE := sample
  9. # Build a static jar file.
  10. include $(BUILD_STATIC_JAVA_LIBRARY) 
(10)Android.mk的編譯模塊中間可以定義相關的編譯內容,也就是指定相關的變量如下:

[code]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 //指定模塊運行所依賴的模塊(模塊安裝時將會同步
安裝它所

沒有留言:

張貼留言