Android.mk用法详解

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

Android.mk文档：

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

基础知识：
1.LOCAL_PATH := $(call my-dir)
每个Android.mk文件都以LOCAL_PATH开始，Build System提供的宏函数 my-dir，此变量返回包含的makefile的路径；CLEAR_VARS不会清楚LOCAL_PATH变量；

NDK提供的宏函数；
2. include $(CLEAR_VARS)：
CLEAR_VARS变量由Build System提供，并指向一个特定的GNU Makefile，可为你清除LOCAL_xxx变量，但不会清除LOCAL_PATH变量；
因系统在单一GNU Make执行环境中解析所有构建控制文件，LOCAL_xxx变量是全局的，所以描述每个模块之前，声明此变量，可以清除所有了LOCAL_xxx，这样清理后避免相互影响；

3.LOCAL_MODULE
此变量声明模块名称，名称必须唯一且不含任何空格；
Build System在生成最终共享库文件时，会将"lib"作为前缀+模块名称+".so"作为共享库文件名称；
eg：LOCAL_MODULE := ffmpeg-decoder
模块名称为ffmpeg-decoder生成共享库为libffmpeg-decoder.so；
4. LOCAL_SRC_FILES := FFmpegDecoder.cpp FFmpegConfigure.cpp
此变量必须包含要构建到模块中的C/C++源文件列表，不需要列出头文件和包含文件，系统会自动导入依赖；
eg: LOCAL_SRC_FILES := FFmpegDecoder.cpp FFmpegConfigure.cpp
5. LOCAL_C_INCLUDES
变量设置头文件的include目录列表；
eg: LOCAL_C_INCLUDES += $LOCAL_PATH)/include 6. LOCAL_LDLIBS 此变量包含构建共享库或可执行文件时链接库，使用-l前缀传递特定系统库的名称，多个链接库之间使用空格作为分隔符； NDK为Android版本提供新的头文件和库，文件路径：$ NDK/platforms/android-//usr/include下；
-llog链接到系统的liblog.so文件，应用可以定义从原生代码向内核发送日志消息，路径：/system/lib/liblog.so，其实是导入<android/log.h>头文件，路径：$NDK/platforms/android-3/arch-arm/usr/include/android/log.h

变量列表：
-llog(日志库)：导入log.h头文件
-lz(ZLib压缩库)：添加zlib.h和zconf.h头文件；
-ldl(动态链接器库)：添加dlfcn.h头文件，可以访问Android动态链接器的dlopen()、dlsym()和dlclose()函数；
-lGLESv3(OpenGL ES3.1库)：此变量API 21开始，添加gl31.h和gl3ext.h头文件，提供了渲染机制，参考EGL原生平台接口；从API 9开始提供EGL API,可以使用GLSurfaceView;
-ljnigraphics：允许C/C++以可靠方式访问Java位图对象的像素缓冲区，导入bitmap.h头文件，jnigraphics工作流程参考：NDK API中的jnigraphics;
-lOpenMAXAL（多媒体库）：导入OMXAL/OpenMAXAL.h和OMXAL/OpenMAXAL_Platform.h头文件，提供原生多媒体处理库；
-landroid（android原生头文件库）：原生头文件列表包括native_activity.h、looper.h、input.h、keycodes.h等等，如需了解头文件详情参考：NDK API参考文档；
https://developer.android.google.cn/ndk/guides/stable_apis
eg:LOCAL_LDLIBS := -llog -lz
7. LOCAL_SHARED_LIBRARIES := avcodec avdevice
此变量是此模块运行中依赖的共享库模块列表，avcodec和avdevice都是前面定义的共享模块库；
eg:
8. include $(BUILD_SHARED_LIBRARY)
此变量设置Build System提供的变量执行GNU Makefile脚本，表示指定模块的生成方式；
BUILD_SHARED_LIBARAY：编译为动态库；
BUILD_SHARED_LIBRARY：编译为动态库（.so），这里的LOCAL_SRC_FILES的值为.c/.cpp;
BUILD_STATIC_LIBRARY：编译为静态库（.a），这里的LOCAL_SRC_FILES的值为*.c/.cpp;
BUILD_EXECUTABLE：编译为Native C可执行程序；
PREBUILT_SHARED_LIBRARY：编译为动态库（.so），与BUILD_SHARED_LIBRARY不同，这里LOCAL_SRC_FILES的值不能是源文件，而是库文件；
PREBUILD_STATIC_LIBRARY：编译静态库；
9：TARGET_PLATFORM、TARGET_ARCH_ABI和TARGET_ABI
TARGET_PLATFORM：构建系统目标的Android API level；
eg:TARGET_PLATFORM := android-22
TARGET_ARCH_ABI ：此变量将CPU和架构的ABI存储到目标；eg:TARGET_ARCH_ABI := arm64-v8a
TARGET_ABI：设置Android API level和ABI的联结；
eg:TARGET_ABI := android-22-arm64-v8a

注：Android.mk中的TARGET_xxx与Application.mk中的APP_xxx中的变量设置相似；

LOCAL_MODULE_FILENAME
模块只设置LOCAL_MODULE而不设置LOCAL_MODULE_FILENAME，就会以“lib”前缀+module名称+“.so”命名生成的动态库名称，如果我们需要自己设置生成动态库名称就可以通过LOCAL_MODULE_FILENAME进行设置；
LOCAL_CPP_EXTENSION
此变量设置C++源文件以外的文件扩展名；
eg：LOCAL_CPP_EXTENSION := .cxx .cpp .cc .c
12.LOCAL_CPP_FEATURES
此变量指明代码依赖于特定的C++功能；
eg:LOCAL_CPP_FEATURES := rtti exceptions features
rtti：指明使用RTTI（运行时类型信息）；
exceptions：指明代码使用C++异常；
LOCAL_C_INCLUDES
此变量指定相对于NDK root目录的路径列表，在编译所有源文件(C、C++和Assembly)时添加到include搜索路径；
LOCAL_ARM_MODE
此变量指定生成ARM目标二进制文件；
LOCAL_ARM_NEON
此变量设置支持NEON,
eg: LOCAL_ARM_NEON := true
LOCAL_THIN_ARCHIVE
此变量设置为true，构建静态库时生成一个只包含实际对象的文件路径而不包含对象的库，好处是库文件变小了，但是不能进行移植，因为所有的路径是相对路径.