分享

Android.mk解析

 James130 2015-10-12
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 := 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 $(BUILD_PACKAGE)

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)

编译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./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

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多