Android.mk文件总结

1、 设置当前模块的编译路径为当前文件夹路径

LOCAL_PATH := $(call my-dir)

2、清理(可能由其他模块设置过的)编译环境中用到的变量

include $(CLEAR_VARS)

3、模块编译变量

变量                          用途
   LOCAL_SRC_FILES               当前模块包含的源代码文件
   LOCAL_MODULE                  当前模块的名称，这个名称应当是唯一的，模块间的依赖关系就是通过这个名称来引用的
   LOCAL_C_INCLUDES              C/C++ 语言需要的头文件的路径
   LOCAL_STATIC_LIBRARIES        当前模块在静态编译时，需要的静态库
   LOCAL_SHARED_LIBRARIES        当前模块在运行时依赖的动态库
   LOCAL_CFLAGS                  C/C++编译器的参数
   
   include $(BUILD_EXECUTABLE)
   # -I$(LOCAL_C_INCLUDES)       指定头文件搜索路径
   # -l$(LOCAL_SHARED_LIBRARIES) 指令链接的动态库
   gcc $(LOCAL_CFLAGS) $(LOCAL_SRC_FILES) -o $(LOCAL_MODULE) -I$(LOCAL_C_INCLUDES) $(LOCAL_STATIC_LIBRARIES) -l$(LOCAL_SHARED_LIBRARIES) 
   
   LOCAL_JAVA_LIBRARIES          当前模块依赖的Java共享库
   LOCAL_STATIC_JAVA_LIBRARIES   当前模块依赖的Java静态库
   LOCAL_PACKAGE_NAME            当前模块的APK应用的名称
   
   LOCAL_CERTIFICATE             签署当前应用的证书名称
   
   LOCAL_MODULE_TAGS             当前模块所包含的标签，Android.mk的必选，一个模块可以包含多个标签
                                 标签的值可能是debug, eng, tests, samples 或 optional
                                 
   build/core/definitions.mk
   通常会用下面函数获取上面环境变量的值：
   提供配置编译需要的函数
   $(call my-dir)                        获取当前文件夹路径
   $(call all-subdir-java-files)         获取当前目录子目录下所有的java源代码文件
   $(call all-java-files-under, 目录)    获取指定目录下的所有Java文件
   $(call all-c-files-under, 目录)       获取指定目录下的所有C语言文件
   $(call all-Iaidl-files-under, 目录)   获取指定目录下的所有 AIDL 文件
   $(call all-makefiles-under, 目录)     获取指定目录下的所有Make文件

4、模块类型

BUILD_EXECUTABLE              编译目标机上的可执行文件(ELF)
BUILD_STATIC_LIBRARY          编译目标机上的静态库(*.a 编译时使用)
BUILD_SHARED_LIBRARY          编译目标机上的动态库文件(*.so)
BUILD_JAVA_LIBRARY            编译目标机上的java动态库
BUILD_STATIC_JAVA_LIBRARY     编译目标机上的java静态库
BUILD_PACKAGE                 编译目标机上的java包

5、几个常见的模板

• 编译可执行程序的模板

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)

（菜鸟级别解释：:=是赋值的意思，$是引用某变量的值）
 LOCAL_SRC_FILES中加入源文件路径，LOCAL_C_INCLUDES 中加入所需要包含的头文件路径，
 LOCAL_STATIC_LIBRARIES加入所需要链接的静态库（*.a）的名称，
 LOCAL_SHARED_LIBRARIES中加入所需要链接的动态库（*.so）的名称，
 LOCAL_MODULE表示模块最终的名称，
 BUILD_EXECUTABLE表示以一个可执行程序的方式进行编译。

• 编译静态库的模板

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)
一般的和上面相似，BUILD_STATIC_LIBRARY表示编译一个静态库。

• 编译动态库的模板

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)
   一般的和上面相似，BUILD_SHARED_LIBRARY表示编译一个共享库。
以上三者的生成结果分别在如下，generic依具体target会变：
out/target/product/xxxx/obj/EXECUTABLE
out/target/product/xxxxx/obj/STATIC_LIBRARY
out/target/product/xxxx/obj/SHARED_LIBRARY 
  每个模块的目标文件夹分别为：
  1.可执行程序：XXX_intermediates
  2.静态库：XXX_static_intermediates
  3.动态库：XXX_shared_intermediates

• 编译一个简单apk

LOCAL_PATH := $(call my-dir)  
include $(CLEAR_VARS)   
LOCAL_SRC_FILES := $(call all-subdir-java-files) 
LOCAL_PACKAGE_NAME := LocalPackage   
include $(BUILD_PACKAGE)

• Android Studio项目在源码中Android.mk

LOCAL_PATH := $(call my-dir)


include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_CERTIFICATE := platform
LOCAL_PACKAGE_NAME := Demo
LOCAL_DEX_PREOPT = true
LOCAL_MULTILIB :=both


src_dir = app/src/main/java
res_dir = app/src/main/res
libs_dir = app/libs

LOCAL_MANIFEST_FILE := app/src/main/AndroidManifest.xml  

LOCAL_SRC_FILES := $(call all-java-files-under, $(src_dir))
#LOCAL_SRC_FILES := $(call all-subdir-java-files)

LOCAL_STATIC_JAVA_LIBRARIES := \
	android-support-v4 \
	android-support-v7-appcompat \
	android-support-v7-cardview \
	gson \
	okio \
	okhttp \
	android-support-v7-recyclerview \
	android-support-v7-palette


LOCAL_RESOURCE_DIR := \
   $(LOCAL_PATH)/$(res_dir) \
   frameworks/support/v7/appcompat/res \
   frameworks/support/v7/cardview/res \
   frameworks/support/v7/recyclerview/res 


LOCAL_AAPT_FLAGS := \
  --auto-add-overlay \
  --extra-packages android.support.v7.appcompat \
  --extra-packages android.support.v7.cardview \
  --extra-packages android.support.v7.recyclerview

include $(BUILD_PACKAGE)


include $(CLEAR_VARS)
# Use the folloing include to make our test apk.
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := gson:app/libs/gson-2.7.jar \
                                        okio:app/libs/okio-1.6.0.jar \
				                        okhttp:app/libs/okhttp-3.2.0.jar
include $(BUILD_MULTI_PREBUILT)

##################################################
include $(call all-makefiles-under,$(LOCAL_PATH))