Android.mk的文件梳理

1.android.mk的简要概述

一个Android.mk file用来向编译系统描述你的源代码。具体来说：该文件是GNU Makefile的一小部分，会被编译系统解析一次或多次。你可以在每一个Android.mk file中定义一个或多个模块。每个模块属下列类型之一：
1）APK程序，一般的Android程序，编译打包生成apk文件
2）Java库，java类库，编译打包生成jar文件
3) C\C++应用程序，可执行的C\C++应用程序
4）C\C++静态库，编译生成C\C++静态库，并打包成.a文件
5）C\C++共享库， 编译生成共享库（动态链接库），并打包成.so， 有且只有共享库才能被安装/复制到您的应用软件（APK）包中。

换句话说和qt的.pro，写c++的CMakeLists.tx的功能是一致的，像LZ现在说要做c++和android的交叉应用，那么应用c++的时候需要借助ndk-build对一些c++源文件进行编译，相当于把c++文件编译成一个库，在java层进行库的调用，最后封装成apk在手机上使用这个android的应用。

网上已经有很多讲述hello-jni的例子了，LZ直接就一条命令一条命令解释了，github上也有很多samples，如果感兴趣可以深入在多了解了解。

LOCAL_PATH := $(call my-dir)

一般Android.mk文件的第一行就是以这句开头，而且也必须以这句开头，它是用来定位源代码的。在上述那行代码中，宏“call my-dir”由构建内部系统提供，用来返回当前的路径，即包含Android.mk本身的目录。

include $(CLEAR_VARS)

CLEAR_VARS由编译系统提供(可以在 android 安装目录下的/build/core/config.mk 文件看到其定义，为 CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk)，指定让GNU MAKEFILE为你清除许多LOCAL_XXX变量（例如 LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES, 等等…),除LOCAL_PATH 。这是必要的，因为所有的编译控制文件都在同一个GNU MAKE执行环境中，所有的变量都是全局的。如果一个工程需要编译很多第三方库，最后工程中对库进行引用，那么编译每个库的时候都要加上这句指令，不然很容易编译报错，不通过。

LOCAL_MODULE := your module name

这是用来定义你的模块名的，它的名字必须是唯一的，不能包含空格。需要注意的是，NDK构建系统会自动为所生成的目标模块加上前缀和扩展名，比如FRR模块，最终终会生成libFRR.so，但是在java层调用库的时候还是只要写成如下

    static {
        System.loadLibrary("FRR");
    }

就行了，不用加上前缀和扩展。如果自己定义的模块名就包含前缀，例如libFRR，那么在NDK构建中，生成的目标库还是libFRR.so。这点还是要注意一下的。

LOCAL_SRC_FILES ：= your source files

这个指令是用来列出需要编译的C源码或C++源码。在这个Android.mk中有一点挺方便的，就是不需要列出所需要的头文件，因为在编译是时候，NDK构建的系统会自动为你找到对应的头文件。

另一个值得注意的是，默认c++的扩展名为cpp，但也可以通过变量

LOCAL_CPP_EXTENSION

来定义不同的扩展名，用这个变量是设置其值时千万别忘了第一个字符是点，通常LZ的习惯是不管是.cpp，还是.cc都显示的定义出来。

LOCAL_CPP_EXTENSION := .cpp  

BUILD_SHARED_LIBRARY

这个命令是负责收集上次执行‘include $(CLEAR_VARS)’以来的所有LOCAL_XXX变量信息，和决定最终生成什么，以及如何精确地构建动态库。BUILD_STATIC_LIBRARY与此类似，并决定如何将你列出的Source编译成一个静态库。 静态库不能够加入到Project 或者APK中。但它可以用来生成动态库。

如果是一般比较小的测试工程，上述已经可以构建一套完整的Android.mk文件啦。

但是，一般的工程是不会这么简单的，下面还有一些常用命令也会在构建Android.mk是使用到。

在编写Android.mk文件时是有一个原则的，就是尽量少的定义自己的变量，如果定义的话，要注意不要跟NDK编译系统预定的变量相冲突。

编译预定的变量名拥有以下规则：
-前缀LOCAL_开头（如：LOCAL_MODULE）
-前缀PRIVATE_, NDK_ or APP_开头（系统内容使用）
-小写字母（内容使用，如.’my-dir’）

如果小伙伴想自定义变量的话，建议使用前缀MY_, 如下代码所示;

MY_SOURCE := FRR.c
ifneq ($(MY_CONFIG_BAR),)
    MY_SOURCE += bar.c
endif

LOCAL_SRC_FILES += $(MY_SOURCES)

BUILD_EXECUTABLE:

与前面类似，它也指向一个编译脚本，收集自从上次调用’ include $(CLEAR_VARS) ’ 后的所有LOCAL_XXX信息。并决定如何将你列出的Source编译成一个可执行Native程序。

include $(BUILD_EXECUTABLE) 

PREBUILT_SHARED_LIBRARY：

把这个共享库声明为 “一个” 独立的模块。 指向一个build 脚本，用来指定一个预先编译好多动态库。 与BUILD_SHARED_LIBRARY and BUILD_STATIC_LIBRARY不同，

此时模块的LOCAL_SRC_FILES应该被指定为一个预先编译好的动态库，而非source file.

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)
LOCAL_MODULE := frr-prebuilt     # 模块名
LOCAL_SRC_FILES := libfrr.so     # 模块的文件路径（相对于 LOCAL_PATH）

include $(PREBUILT_SHARED_LIBRARY) # 注意这里不是 BUILD_SHARED_LIBRARY

这个共享库将被拷贝到 ‘ PROJECT/obj/local′和′ PROJECT/libs/’ (stripped) 主要是用在将已经编译好的第三方库

使用在本Android Project中。为什么不直接将其COPY到libs/armabi目录呢？因为这样做缺陷很多,将会在后文中详细说明。

PREBUILT_STATIC_LIBRARY:

预先编译的静态库。 同上。

TARGET_ARCH:

目标ＣＰＵ架构名。如果为　“arm” 则声称ARM兼容的指令。与CPU架构版本无关。

TARGET_PLATFORM:
指定目标Android平台的名字。

TARGET_ARCH_ABI:
目标CPU+ABI的名字。目前支持两个选择：
armeabi For ARMv5TE armeabi-v7a

TARGET_ABI
目标平台和ABI连起来的名字，它的值为‘ (TARGETPLATFORM)′−′ (TARGET_ARCH_ABI)’的形式，当你在真实设备上测试制定系统镜像时将变得很有用。

下面再讨论一下NDK讨论的一部分宏定义：
这些宏将以

$（call <function>）的形式被使用，它返回文本信息。

#my-dir: $(call my-dir): 

返回最近一次include的Makefile的路径。通常返回Android.mk所在的路径。它用来作为Android.mk的开头来定义LOCAL_PATH.  

#LOCAL_PATH := $(call my-dir) 

请注意：返回的是最近一次include的Makefile的路径。所以在Include其它Makefile后，再调用$(call my-dir)会返回其它Android.mk 所在路径。

例如：  

#LOCAL_PATH := $(call my-dir)   
... declare one module   include $(LOCAL_PATH)/frr/Android.mk   LOCAL_PATH := $(call my-dir)   ... declare another module
则第二次返回的LOCAL_PATH　为：$PATH/frr。 而非$PATH.   

#all-subdir-makefiles:
返回一个列表，包含'my-dir'中所有子目录中的Android.mk。   
例如： 结构如下：  
sources/frr/Android.mk   sources/frr/lib1/Android.mk   sources/frr/lib2/Android.mk 
在If sources/frr/Android.mk 中， include $(call all-subdir-makefiles)  那则自动include 了sources/frr/lib1/Android.mk and sources/frr/lib2/Android.mk。

#this-makefile： 
当前Makefile的路径。      

#parent-makefile：  
返回include tree中父Makefile 路径。 也就是include 当前Makefile的Makefile Path。  

#import-module： 
允许寻找并inport其它modules到本Android.mk中来。 它会从NDK_MODULE_PATH寻找指定的模块名。  
$(call import-module,<name>)

接下来是模块描述变量：

此类变量用来给Build System描述模块信息。在’include (CLEARVARS)′和′include (BUILD_XXXXX)’之间。必须定义此类变量。
include $(CLEAR_VARS)

script用来清空这些变量。

include $(BUILD_XXXXX)

收集和使用这些变量。

LOCAL_PATH:

这个值用来给定当前目录。必须在Android.mk的开是位置定义之。
例如：

LOCAL_PATH := $(call my-dir)

LOCAL_PATH不会被include ‘$(CLEAR_VARS) ‘清理。

LOCAL_MODULE:
modules名。在include’ $(BUILD_XXXXX)’之前，必须定义这个变量。此变量必须唯一且不能有空格。
通常，由此变量名决定最终生成的目标文件名。

LOCAL_MODULE_FILENAME:

可选。用来override LOCAL_MODULE. 即允许用户重新定义最终生成的目标文件名。

LOCAL_MODULE := frr-version-1  
LOCAL_MODULE_FILENAME := libfrr

LOCAL_SRC_FILES：

为Build Modules而提供的Source 文件列表。不需要列出依赖文件。 注意：文件相对于LOCAL_PATH存放，
且可以提供相对路径。 例如：
LOCAL_SRC_FILES := frr.c \ toto/bar.c

LOCAL_CPP_EXTENSION:

指出C++ 扩展名。(可选)

LOCAL_CPP_EXTENSION := .cxx 从NDK R7后，可以写多个：  
LOCAL_CPP_EXTENSION := .cxx .cpp .cc      

LOCAL_CPP_FEATURES：

可选。用来指定C++ features。

LOCAL_CPP_FEATURES := rtti  
LOCAL_CPP_FEATURES := exceptions

LOCAL_C_INCLUDES：

一个可选的path列表。相对于NDK ROOT 目录。编译时，将会把这些目录附上。

LOCAL_C_INCLUDES := sources/frr  
LOCAL_C_INCLUDES := $(LOCAL_PATH)/frr

LOCAL_CFLAGS:

一个可选的设置，在编译C/C++ source 时添加如Flags。 用来附加编译选项。 注意：不要尝试在此处修改编译的优化选项和Debug等级。它会通过您Application.mk中的信息自动指定。 也可以指定include 目录通过：LOCAL_CFLAGS += -I。 这个方法比使用LOCAL_C_INCLUDES要好。因为这样也可以被ndk-debug使用。

LOCAL_CXXFLAGS:

LOCAL_CPPFLAGS的别名。

LOCAL_CPPFLAGS:

C++ Source 编译时添加的C Flags。这些Flags将出现在LOCAL_CFLAGS flags 的后面。

LOCAL_STATIC_LIBRARIES:

要链接到本模块的静态库list。(built with BUILD_STATIC_LIBRARY)

LOCAL_SHARED_LIBRARIES:

要链接到本模块的动态库。

LOCAL_WHOLE_STATIC_LIBRARIES：

静态库全链接。 不同于LOCAL_STATIC_LIBRARIES，类似于使用–whole-archive

LOCAL_LDLIBS：

linker flags。 可以用它来添加系统库。 如 -lz:

LOCAL_LDLIBS := -lz   

LOCAL_ALLOW_UNDEFINED_SYMBOLS:
在编译过程可能会出现各种error: undefined reference to“xxxxx”的问题，请务必要一个个解决，网上流传的在mk里加入

LOCAL_ALLOW_UNDEFINED_SYMBOLS := true

可能编译通过但是在用上so库运行时会出现各种错误

LOCAL_ARM_MODE:
缺省模式下，ARM目标代码被编译为thumb模式。每个指令16位。如果指定此变量为：arm。 则指令为32位。

LOCAL_ARM_MODE := arm

其实也可以指定某一个或者某几个文件的ARM指令模式。

LOCAL_ARM_NEON:

设置为true时，会讲浮点编译成neon指令。这会极大地加快浮点运算(前提是硬件支持)
只有targeting 为 ‘armeabi-v7a’时才可以。

LOCAL_DISABLE_NO_EXECUTE：

Android NDK r4版本开始支持这种”NX bit”的安全功能。默认是启用的，你也可以设置该变量的值为true来禁用它。但不推荐这么做。该功能不会修改ABI，只在ARMv6+CPU的设备内核上启用。

LOCAL_EXPORT_CFLAGS:

定义这个变量用来记录C/C++编译器标志集合，
并且会被添加到其他任何以LOCAL_STATIC_LIBRARIES和LOCAL_SHARED_LIBRARIES的模块的LOCAL_CFLAGS定义中

LOCAL_SRC_FILES := foo.c bar.c.arm 

写了一上午。。。收获满满O(∩_∩)O哈哈~

参考博客：
http://www.cnblogs.com/alphagl/p/6132050.html
http://www.cnblogs.com/wainiwann/p/3837936.html