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.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++可执行程序，以及对应的动态库和静态库

4. 一些有用的编译模板

• 编译apk

          LOCAL_PATH := $(call my-dir)

          include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := optional

LOCAL_STATIC_JAVA_LIBRARIES := gson2.2 aquery v3dcore asupport socketio

LOCAL_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 := overlay

LOCAL_PACKAGE_NAME := T2Launcher

LOCAL_CERTIFICATE := platform

ifeq ($(findstring full_mstarnapoli,$(TARGET_PRODUCT)),full_mstarnapoli)

    LOCAL_JAVA_LIBRARIES := com.mstar.android

endif

include $(CLEAR_VARS)

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := gson2.2:libs/gson-2.2.2.jar

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += aquery:libs/android-query.0.24.3.jar

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += v3dcore:libs/V3DCore.jar

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += asupport:libs/android-support-v4.jar

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += socketio:libs/android-websockets.jar

include $(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 := liblinkshell

LOCAL_MODULE_TAGS := optional

LOCAL_MODULE_CLASS := SHARED_LIBRARIES

LOCAL_CERTIFICATE := platform

LOCAL_MODULE_SUFFIX := .so

LOCAL_SRC_FILES := xxx.so

include $(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 := debug

include $(BUILD_PREBUILT)  

• 集成prebuild应用程序apk

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

vendor/BM/APPs/MobileQQ2011/MobileQQ2011.apk

vendor/BM/APPs/MobileQQ2011/Android.mk

LOCAL_PATH := $(call my-dir) 

include $(CLEAR_VARS) 

# Module name should match apk name to be installed.

LOCAL_MODULE := MobileQQ2011

LOCAL_MODULE_TAGS := optional

LOCAL_MODULE_CLASS := APPS

LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)

LOCAL_SRC_FILES := $(LOCAL_MODULE).apk

LOCAL_CERTIFICATE := platform

include $(BUILD_PREBUILT)

     方法二：纯粹拷贝apk文件

vendor/BM/APPs/MobileQQ2011.apk

vendor/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