Android.mk解析

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.mk
BUILD_STATIC_LIBRARY	编译成静态库	前缀为lib，后缀为.a	build/core/host_static_library.mk
BUILD_SHARED_LIBRARY	编译成动态库	前缀为lib，后缀为.so	build/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	.zip
  COMMON_JAVA_PACKAGE_SUFFIX	.jar
  COMMON_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++可执行程序，以及对应的动态库和静态库

4. 一些有用的编译模板

• 编译apk

          LOCAL_PATH := $(call my-dir)          include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := optionalLOCAL_STATIC_JAVA_LIBRARIES := gson2.2 aquery v3dcore asupport socketioLOCAL_SRC_FILES := $(call all-java-files-under, src) /                   src/com/letv/t2/launcher/aidl/service/LiveLayerStatusBinderInterface.aidl /                   src/com/letv/t2/launcher/aidl/service/BarrageObserver.aidl /# Add overlay folder.LOCAL_PACKAGE_OVERLAYS := overlayLOCAL_PACKAGE_NAME := T2LauncherLOCAL_CERTIFICATE := platformifeq ($(findstring full_mstarnapoli,$(TARGET_PRODUCT)),full_mstarnapoli)    LOCAL_JAVA_LIBRARIES := com.mstar.androidendifinclude $(CLEAR_VARS)LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := gson2.2:libs/gson-2.2.2.jarLOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += aquery:libs/android-query.0.24.3.jarLOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += v3dcore:libs/V3DCore.jarLOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += asupport:libs/android-support-v4.jarLOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += socketio:libs/android-websockets.jarinclude $(BUILD_MULTI_PREBUILT)include $(BUILD_PACKAGE)

• 编译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)  

• 编译C，C++应用程序

LOCAL_PATH := $(call my-dir)  #include $(CLEAR_VARS)  LOCAL_SRC_FILES := main.c  LOCAL_MODULE := test_exe  #LOCAL_C_INCLUDES :=  #LOCAL_STATIC_LIBRARIES :=  #LOCAL_SHARED_LIBRARIES :=  include $(BUILD_EXECUTABLE)  

• 编译C，C++静态库

LOCAL_PATH := $(call my-dir)  include $(CLEAR_VARS)  LOCAL_SRC_FILES :=  helloworld.c  LOCAL_MODULE:= libtest_static  #LOCAL_C_INCLUDES :=  #LOCAL_STATIC_LIBRARIES :=  #LOCAL_SHARED_LIBRARIES :=  include $(BUILD_STATIC_LIBRARY)  

• 编译C，C++动态库

LOCAL_PATH := $(call my-dir)  include $(CLEAR_VARS)  LOCAL_SRC_FILES := helloworld.c  LOCAL_MODULE := libtest_shared  TARGET_PRELINK_MODULES := false  #LOCAL_C_INCLUDES :=  #LOCAL_STATIC_LIBRARIES :=  #LOCAL_SHARED_LIBRARIES :=  include $(BUILD_SHARED_LIBRARY)  

生成结果的目录：

1）out/target/product/generic/obj/APPS  2）out/target/product/generic/obj/JAVA_LIBRARIES  3）out/target/product/generic/obj/EXECUTABLE  4）out/target/product/generic/obj/STATIC_LIBRARY  5）out/target/product/generic/obj/SHARED_LIBRARY 

每个模块的目标文件夹为：

1）APK程序：XXX_intermediates 2）JAVA库程序：XXX_intermediates 这里的XXX 3）CC++可执行程序：XXX_intermediates 4）CC++静态库： XXX_static_intermediates 5）CC++动态库： XXX_shared_intermediates

参考链接：http://www.bdqn.cn/news/201307/10450.shtml

5. 加载第三方应用和类库

• 集成静态库

LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_PREBUILT_LIBS := libA.a libB.a          LOCAL_STATIC_LIBRARIES := libA libB  include $(BUILD_MULTI_PREBUILT)

• 集成动态库

LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE := liblinkshellLOCAL_MODULE_TAGS := optionalLOCAL_MODULE_CLASS := SHARED_LIBRARIESLOCAL_CERTIFICATE := platformLOCAL_MODULE_SUFFIX := .soLOCAL_SRC_FILES := xxx.soinclude $(BUILD_PREBUILT) 

 

• 集成可执行文件

LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_SRC_FILES := hellovprc.elf LOCAL_MODULE := hellovprc.elf LOCAL_MODULE_CLASS := EXECUTABLES//LOCAL_MODULE_PATH := $(TARGET_OUT)/bin   LOCAL_MODULE_TAGS := debuginclude $(BUILD_PREBUILT)  

• 集成prebuild应用程序apk

     方法一：建立目录结构，如：

vendor/BM/APPs/MobileQQ2011/MobileQQ2011.apkvendor/BM/APPs/MobileQQ2011/Android.mkLOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) # Module name should match apk name to be installed.LOCAL_MODULE := MobileQQ2011LOCAL_MODULE_TAGS := optionalLOCAL_MODULE_CLASS := APPSLOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)LOCAL_SRC_FILES := $(LOCAL_MODULE).apkLOCAL_CERTIFICATE := platforminclude $(BUILD_PREBUILT)

     方法二：纯粹拷贝apk文件

vendor/BM/APPs/MobileQQ2011.apkvendor/BM/APPs/Renren_Android_3.0.2.apk通过android提供的PRODUCT_COPY_FILES这个变量来自动拷贝，只需要给此变量赋值。在任何一个确定加入编译的mk文件中加入PRODUCT_COPY_FILES += /vendor/bm/APPS/MobileQQ2011.apk:system/app/MobileQQ2011.apk/vendor/bm/APPS/Renren_Android_3.0.2.apk:system/app/Renren_Android_3.0.2.apk

6. 参考文档：

http://blog.csdn.net/poolwater/article/details/10491061