Android.mk文件用法详解_android.mk 打包init配置文件

       Android.mk是Android提供的一个makefile文件，可以将源文件分组为模块。用来引用的头文件目录、需要编译的*.c/*.cpp文件、jni源文件、指定编译生成*.so共享库文件或者*.a静态库文件，可以定义一个或多个模块，也可以多个模块中使用同一个源文件； 

 

Android.mk文档：

    1. Android.mk的官方文档：https://developer.android.google.cn/ndk/guides/android_mk
    2. 在NDK中的文档路径：ndk目录下docs中的ANDROID-MK.html文档，eg:android-ndk-r9d/docs/ANDROID-MK.html;

基本格式:

LOCAL_PATH := $(call my-dir)  
include $(CLEAR_VARS)  
................  
LOCAL_xxx       := xxx  
LOCAL_MODULE    := hello-jni  
LOCAL_SRC_FILES := hello-jni.c  
LOCAL_xxx       := xxx  
................  
include $(BUILD_SHARED_LIBRARY)  

LOCAL_PATH变量制定了该.mk的路径，$(call my-dir)调用NDK内部的函数获得当前.mk文件的路径

include $(CLEAR_VARS)清空了除了LOCAL_PATH之外的所有LOCAL_xxx变量的值

省略号中间就是对于模块参数的设置，主要包括：模块名字、模块源文件、模块类型、编译好的模块存放位置、以及编译的平台等

include $(BUILD_xxx_xxx)执行NDK的默认脚本，它会收集include $(CLEAR_VARS)脚本后所有定义的LOCAL_xxx变量，然后根据它们来生成模块。

 

Android.mk语法

• LOCAL_PATH := $(call my-dir) 

每个Android.mk文件必须以定义LOCAL_PATH为开始。它用于在开发tree中查找源文件。宏my-dir 则由Build System提供。返回包含Android.mk的目录路径。

 

• include $(CLEAR_VARS) 

CLEAR_VARS 变量由Build System提供。并指向一个指定的GNU Makefile，由它负责清理很多LOCAL_xxx.
例如：LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES等等，即本模块中不包含的所有的全局变量。但不清理LOCAL_PATH。这个清理动作是必须的，因为所有的编译控制文件由同一个GNU Make解析和执行，其变量是全局的。所以清理后才能避免相互影响。通常一个功能模块以“include$(CLEAR_VARS)”开始。

 

• include $(call all-subdir-makefiles)

返回一个位于当前'my-dir'路径的子目录列表。例如，看下面的目录层次：

sources/foo/Android.mk

sources/foo/lib1/Android.mk

sources/foo/lib2/Android.mk

如果sources/foo/Android.mk包含一行：

include $(call all-subdir-makefiles)

那么它就会自动包含sources/foo/lib1/Android.mk 和sources/foo/lib2/Android.mk

这项功能用于向编译系统提供深层次嵌套的代码目录层次。注意，在默认情况下，ＮＤＫ将会只搜索在sources/*/Android.mk中的文件。

this-makefile

返回当前Makefile的路径（即这个函数调用的地方）

parent-makefile

返回调用树中父Makefile路径。即包含当前Makefile的Makefile路径。

grand-parent-makefile

 

• LOCAL_MODULE    := hello-jni 

LOCAL_MODULE模块必须定义，以表示Android.mk中的每一个模块。名字必须唯一且不包含空格。Build System会自动添加适当的前缀和后缀。例如，foo，要产生动态库，则生成libfoo.so. 但请注意：如果模块名被定为：libfoo.则生成libfoo.so. 不再加前缀

 

• LOCAL_MODULE_PATH :=$(TARGET_ROOT_OUT) 指定最后生成的模块的目标地址

TARGET_ROOT_OUT:根文件系统，路径为out/target/product/generic/root

TARGET_OUT:system文件系统，路径为out/target/product/generic/system

TARGET_OUT_DATA:data文件系统，路径为out/target/product/generic/data

除了上面的这些，NDK还提供了很多其他的TARGET_XXX_XXX变量，用于将生成的模块拷贝到输出目录的不同路径

默认是TARGET_OUT

 

• LOCAL_SRC_FILES := hello-jni.c 

LOCAL_SRC_FILES变量必须包含将要打包如模块的C/C++ 源码。不必列出头文件，build System 会自动帮我们找出依赖文件。缺省的C++源码的扩展名为.cpp. 也可以修改，通过LOCAL_CPP_EXTENSION

注意：在这个模块中必须包含LOCAL_MODULE和LOCAL_SRC_FILES变量并赋值。模块将会编译LOCAL_SRC_FILES指定的资源文件生成一个名为“lib$(LOCAL_MODULE).so”文件

 

• include $(BUILD_SHARED_LIBRARY) 

BUILD_SHARED_LIBRARY：是Build System提供的一个变量，指向一个GNU Makefile Script。
它负责收集自从上次调用 include $(CLEAR_VARS)  后的所有LOCAL_XXX信息。并决定编译为  什么。通常一个模块以“include $(BUILD_XXX)”结束。

BUILD_STATIC_LIBRARY     ：编译为静态库。 

BUILD_SHARED_LIBRARY   ：编译为动态库 

BUILD_EXECUTABLE           ：编译为Native C可执行程序  

BUILD_PREBUILT                 ：该模块已经预先编译

BUILD_PACKAGE                  ：编译成一个apk文件

NDK还定义了很多其他的BUILD_XXX_XXX变量，它们用来指定模块的生成方式。

 

• 其他的LOCAL_XXX变量

LOCAL_开头的变量都是模块编译内的局部标量，通常在Android.mk开头都要包含：                                                                LOCAL_PATH := $(call my-dir)                                                                                                                                                          include $(CLEAR_VARS)                                                                                                                                                                        这两句，特别是include $(CLEAR_VARS)这个会清除上一个模块编译时候留下的所有LOCAL_变量，以准备给当前模块使用。

LOCAL_C_INCLUDES：额外的C/C++编译头文件路径，用LOCAL_PATH表示本文件所在目录，像gcc的-I参数。如：LOCAL_C_INCLUDES += $(LOCAL_PATH)/include

LOCAL_CC：另外指定c编译器，不使用默认的。

LOCAL_CXX：指定C++编译器

LOCAL_CFLAGS：为C编译器传递额外的参数(如宏定义)，举例：LOCAL_CFLAGS += -DLIBUTILS_NATIVE=1

LOCAL_CPP_EXTENSION：如果你的C++文件不是以cpp为文件后缀，你可以通过LOCAL_CPP_EXTENSION指定C++文件后缀名。       如：LOCAL_CPP_EXTENSION := .cc注意统一模块中C++文件后缀必须保持一致。

LOCAL_CPPFLAGS：传递额外的参数给C++编译器，如：LOCAL_CPPFLAGS += -ffriend-injection -DLIBUTILS_NATIVE

LOCAL_COPY_HEADERS_TO 和 LOCAL_COPY_HEADERS：把需要暴露给外部的头文件copy到这个路径下。                              LOCAL_COPY_HEADERS_TO 安装应用程序时复制头文件的目的路径                                                              LOCAL_COPY_HEADERS 指定要 copy 的头文件。

LOCAL_STATIC_LIBRARIES: 表示该模块需要使用哪些静态库，以便在编译时进行链接。

LOCAL_SHARED_LIBRARIES: 表示模块在运行时要依赖的共享库（动态库），在链接时就需要，以便在生成文件时嵌入其相应的信息。注意：它不会附加列出的模块到编译图，也就是仍然需要在Application.mk 中把它们添加到程序要求的模块中。                                                                                                  

重要   下面三条变量为链接库相关：

LOCAL_LDLIBS：故名思议，ldlibs，就是指定那些存在于系统目录下本模块需要连接的库。如果某一个库既有动态库又有静态库，那么在默认情况下是链接的动态库而非静态库。                                                                                                                                    如：LOCAL_LDLIBS += -lm –lz –lc -lcutils –lutils –llog …                                                                                                                      如果你的Android.mk文件中只有这么一行，那么将会采用动态链接。这个类似于上面用gcc编译时直接指定库是一样的道理。

LOCAL_LDFLAGS：这个编译变量传递给链接器一个一些额外的参数，比如想传递而外的库和库路径给ld，或者传递给ld linker的一些链接参数，-On，-EL{B}(大小端字节序)，那么就要加到这个上面，如：                                                                                          LOCAL_LDFLAGS += -L$(LOCAL_PATH)/lib/ -lHWrecog –EB{EL} –O{n} …                                                                                        或者直接加上绝对路径库的全名：                                                                                                                                                          LOCAL_LDFLAGS += $(LOCAL_PATH)/lib/libHWrecog.a –EB{EL} –O{n}

LOCAL_FORCE_STATIC_EXECUTABLE：如果编译时候需要链接的动态库库存在静态库形式，那么在这个编译变量等于true的情况下，将会链接到对应的静态库而不是动态库。比如上面列出的libm，libz，libc，libcutils，libutils，liblog等动静态库都存在，那么在该变量被置true的时候，将会链接对应的静态库。当然对于本来就是静态库的libHWrecog.a来说，该变量值不会影响它是被静态链接的。所以可以想到这个参数的设置是和前面用gcc编译时候指定-static参数一样的效果, 推荐只是编译特殊ELF文件才用。

       通常这种情况只会在编译root/sbin目录下的应用才会用到，应为通常他们执行的时间比较早，文件系统的其他部分都没加载，所以动态库就会链接不上，这个时候静态链接是最好不过了。不过在android的系统中好像没有怎么用到，因为linux一起来就是执行的init进程，就开始引导android系统了。

 

Android.mk模板

#编译静态库    
LOCAL_PATH := $(call my-dir)    
include $(CLEAR_VARS)    
LOCAL_MODULE = libhellos    
LOCAL_CFLAGS = $(L_CFLAGS)    
LOCAL_SRC_FILES = hellos.c    
LOCAL_C_INCLUDES = $(INCLUDES)    
LOCAL_SHARED_LIBRARIES := libcutils    
LOCAL_COPY_HEADERS_TO := libhellos    
LOCAL_COPY_HEADERS := hellos.h    
include $(BUILD_STATIC_LIBRARY)   
 
#编译动态库    
LOCAL_PATH := $(call my-dir)    
include $(CLEAR_VARS)    
LOCAL_MODULE = libhellod    
LOCAL_CFLAGS = $(L_CFLAGS)    
LOCAL_SRC_FILES = hellod.c    
LOCAL_C_INCLUDES = $(INCLUDES)    
LOCAL_SHARED_LIBRARIES := libcutils    
LOCAL_COPY_HEADERS_TO := libhellod    
LOCAL_COPY_HEADERS := hellod.h    
include $(BUILD_SHARED_LIBRARY)  
 
   
#使用静态库    
LOCAL_PATH := $(call my-dir)    
include $(CLEAR_VARS)    
LOCAL_MODULE := hellos    
LOCAL_STATIC_LIBRARIES := libhellos    
LOCAL_SHARED_LIBRARIES :=    
LOCAL_LDLIBS += -ldl    
LOCAL_CFLAGS := $(L_CFLAGS)    
LOCAL_SRC_FILES := mains.c    
LOCAL_C_INCLUDES := $(INCLUDES)    
include $(BUILD_EXECUTABLE)    
 
 
#使用动态库    
LOCAL_PATH := $(call my-dir)    
include $(CLEAR_VARS)    
LOCAL_MODULE := hellod    
LOCAL_MODULE_TAGS := debug    
LOCAL_SHARED_LIBRARIES := libc libcutils libhellod    
LOCAL_LDLIBS += -ldl    
LOCAL_CFLAGS := $(L_CFLAGS)    
LOCAL_SRC_FILES := maind.c    
LOCAL_C_INCLUDES := $(INCLUDES)    
include $(BUILD_EXECUTABLE)    
 
#拷贝文件到指定目录  
LOCAL_PATH := $(call my-dir)  
include $(CLEAR_VARS)  
LOCAL_MODULE := bt_vendor.conf  
LOCAL_MODULE_CLASS := ETC  
LOCAL_MODULE_PATH := $(TARGET_OUT)/etc/bluetooth  
LOCAL_MODULE_TAGS := eng  
LOCAL_SRC_FILES := $(LOCAL_MODULE)  
include $(BUILD_PREBUILT)  
 
 
#拷贝动态库到指定目录  
LOCAL_PATH := $(call my-dir)  
include $(CLEAR_VARS)  
#the data or lib you want to copy  
LOCAL_MODULE := libxxx.so  
LOCAL_MODULE_CLASS := SHARED_LIBRARIES  
LOCAL_MODULE_PATH := $(ANDROID_OUT_SHARED_LIBRARIES)  
LOCAL_SRC_FILES := lib/$(LOCAL_MODULE )  
OVERRIDE_BUILD_MODULE_PATH := $(TARGET_OUT_INTERMEDIATE_LIBRARIES)  
include $(BUILD_PREBUILT)  

 

 

参考文章：

https://www.cnblogs.com/reality-soul/p/6893248.html

https://blog.csdn.net/lizhiguo0532/article/details/7219349

https://blog.csdn.net/earbao/article/details/38702245