android.mk 语法

Android编译系统的makefile文件Android.mk写法如下

(1)   Android.mk文件首先需要指定LOCAL_PATH变量，用于查找源文件。由于一般情况下
Android.mk和需要编译的源文件在同一目录下，宏函数“my-dir”右编译系统提供的，用于返回当前路径。所以定义成如下形式：
LOCAL_PATH:=$(call my-dir)
上面的语句的意思是将LOCAL_PATH变量定义成本文件所在目录路径。

(2)   Android.mk中可以定义多个编译模块，每个编译模块都是以include $(CLEAR_VARS)开始
以include $(BUILD_XXX)结束。
include $(CLEAR_VARS)
CLEAR_VARS由编译系统提供，指定让GNUMAKEFILE为你清除除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)   LOCAL_MODULE_TAGS:= optional

(4)     LOCAL_MODULE_TAGS ：=user eng tests optional

(5)     user: 指该模块只在user版本下才编译

(6)     eng: 指该模块只在eng版本下才编译

(7)     tests: 指该模块只在tests版本下才编译

(8)     optional:指该模块在所有版本下都编译

(9)    

(10)        LOCAL_SRC_FILES:编译的源代码文件列表 添加所有的Java 源文件LOCAL_SRC_FILES:= $(call all-java-files-under, src)

(11) LOCAL_SDK_VERSION := current

(12) LOCAL_MODULE:= jar 包名称

(13) LOCAL_PACKAGE_NAME := APK包的名称

(14) LOCAL_JAVA_LIBRARIES := platform core ext依赖的共享jar

(15) LOCAL_STATIC_JAVA_LIBRARIES：=依赖的静态jar包（jar包是使用 include $(BUILD_STATIC_JAVA_LIBRARY)生成的。）

(16) LOCAL_CERTIFICATE:签名认证   

(17) 1.系统中所有使用android.uid.system作为共享UID的APK，都会首先在manifest节点中增加android:sharedUserId="android.uid.system"，然后在Android.mk中增加LOCAL_CERTIFICATE:= platform。  2. 系统中所有使用android.uid.shared作为共享UID的APK，都会在manifest节点中增加android:sharedUserId="android.uid.shared"，然后在Android.mk中增加LOCAL_CERTIFICATE:= shared。  3.系统中所有使用android.media作为共享UID的APK，都会在manifest节点中增加android:sharedUserId="android.media"，然后在Android.mk中增加LOCAL_CERTIFICATE:= media

(18)  编译一个应用程序(APK)
  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
   
  # Tell it to build an APK
  include $(BUILD_PACKAGE)

(19)  编译静态库

#清除java环境变量

include$(CLEAR_VARS)

LOCAL_MODULE_TAGS:= user

#添加aidl文件

LOCAL_SRC_FILES+= src/net/sunniwell/download/aidl/IDownload.aidl

# SDK 版本                

LOCAL_SDK_VERSION:= current

#jar包的名字

LOCAL_MODULE:=DownLoadServerapi               

#编译 DownLoadServerapi  jar包

include $(BUILD_STATIC_JAVA_LIBRARY)

(20) 编译一个依赖于静态Java库(static.jar)的应用程序
  LOCAL_PATH := $(call my-dir)
  include $(CLEAR_VARS)
   
  # List of static libraries to include in the package
  LOCAL_STATIC_JAVA_LIBRARIES := DownLoadServerapi 第三方jar包
   
  # 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)

(21) 编译一个需要用平台的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)

(22) 添加一个静态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)

(23) 引用第三方JAR包方式

#引入第三方包

include $(CLEAR_VARS) 

 

# 表示在当前目录下的lib/iptv.jar进行预处理到android jar包的目录中去

 

#LOCAL_PREBUILT_JAVA_LIBRARIES := libiptv:lib/iptv.jar

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := \

libiptv:lib/iptv.jar 

 

include $(BUILD_MULTI_PREBUILT)

 

需要在编译apk 中进行、并添加

LOCAL_STATIC_JAVA_LIBRARIES := libiptv

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.mkBUILD_STATIC_LIBRARY编译成静态库前缀为lib，后缀为.abuild/core/host_static_library.mkBUILD_SHARED_LIBRARY编译成动态库前缀为lib，后缀为.sobuild/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.zipCOMMON_JAVA_PACKAGE_SUFFIX.jarCOMMON_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++可执行程序，以及对应的动态库和静态库