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) #引入编译规则
静态库不会复制到的APK包中,但是能够用于编译共享库,生成一个名为 lib$(LOCAL_MODULE).a 的文件
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
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
4. 一些有用的编译模板
- 编译apk
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