android 编译系统的 makefile 文件 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_LI
BRARY)
表示编译成动态库。
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:= \
A
udioHardwareGeneric.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_VA
RS)
# 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)
(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_INSTRUME
NTATION_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_MODUL
E_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_PAT
H