详解android.mk-2016.01.18

1 Android.mk作用

当使用JNI开发时，我们需要创建一个native工程，Android.mk就是一个makefile的配置文件，帮助我们把编写的C/C++代码编译成动态或者静态的链接库。

2 示例解析

下面使用一个最简单的Android.mk配置文件引导生成.so动态库。Android.mk文件内容如下：

LOCAL_PATH := $(call my-dir)
LOCAL_CPP_EXTENSION := .cpp
include $(CLEAR_VARS)
LOCAL_MODULE := jni_demo
LOCAL_SRC_FILES := jni_demo.cpp
LOCAL_LDLIBS := -L$(SYSROOT)/usr/lib -llog

include $(BUILD_SHARED_LIBRARY)

第一行: LOCAL_PATH变量用来查找C/C++源文件，my-dir是一个由编译系统提供的宏函数，用于返回Androi.mk文件所在的目录的路径。call函数与GNU makefile中函数意义相同，具体用法可以参见陈皓“跟我一起学Makefile”中的用法。$()是一个引用变量操作符。综上所述，第一行的含义就是，先调用宏函数“my-dir”获取Android.mk文件所在目录路径，然后将Android.mk文件所在路径赋值给LOCAL_PATH变量。

第二行: LOCAL_CPP_EXTENSION变量指定源码文件扩展名

第三行: CLEAR_VARS定义在${NDK_TOOL_PATH}\build\core路径下的build-all.mk文件中，其中NDK_TOOL_PATH指ndk安装根目录。CLEAR_VARS := $(BUILD_SYSTEM)/clear-vars.mk，打开clear-vars.mk文件，查看其注释可知，该mk文件主要用于清除模块内部变量内容，但不会清除LOCAL_PATH的内容。另外，CLEAR_VARS在每个模块文件中应该重复调用。

第四行: LOCAL_MODULE必须定义，文件名必须唯一，而且不能包含空格，另外，编译器可能会添加一些前缀和后缀，来保证文件是一致的，其作用用来指定编译后的模块名称，如上所示，上述的mk文件编译出来的动态库名称将为libjni_demo.so

第五行: 指定编译的源文件，并且文件名都是相对于LOCAL_PATH目录的。多个文件之间可以使用空格或者Tab键分割，可以使用“\”续行。如果追加源代码文件的话，使用“LOCAL_SRC_FILES +=”。关于源码文件编写列表可以参考“编写Android.mk中的LOCAL_SRC_FILES的终极技巧”

第六行: 指定该模块依赖的其他库。-L指定库的路径，-l指定库的名称。

第七行: 执行编译动态库命令，编译动态库。其他可以执行命令：

BUILD_SHARED_LIBRARY #生成一个动态库
BUILD_STATIC_LIBRARY #生成一个静态的库
BUILD_PACKAGE #生成一个APK

3 变量使用

在Android.mk中，同样可以使用变量，并且变量可以在mk文件和cpp文件中使用，具体使用方式如下：

在Android.mk文件中使用变量

USE_VAR := YES
ifeq ($(USE_VAR), YES)

else

endif

在cpp文件中使用mk文件中定义的变量，在mk文件中使用“变量 := -D+变量名”形式定义变量，然后追加到LOCAL_CFLAGS变量中，否则定义的变量将不会生效。

//cpp
#ifdef TCC_MEM_512MB
    LOGD("TCC_MEM_512MB define in here");
#endif

#mk
BOARD_MEM_FLAGS := -DTCC_MEM_512MB
LOCAL_CFLAGS += $(BOARD_MEM_FLAGS)

LOCAL_CFLAGS表示编译器选项，其中有一个作用就是用来定义宏，例如，上面的在cpp文件中使用mk中定义的宏，可以简写成如下形式：

LOCAL_CFLAGS := -DTCC_MEM_512MB

4 源文件列表编写

在参考资料“编写Android.mk中的LOCAL_SRC_FILES的终极技巧”中，详细介绍了如何使用简单有效的手段编写编译的源文件列表，因此，此处不再赘述。

5 使用cygwin+NDK实现JNI开发

安装好cygwin后，按照如下方式配置NDK环境变量：

a.修改C:\cygwin\home\Administrator目录下.bash_profile文件，添加如下内容：

NDK=/cygdrive/d/program/android/ndk/

export NDK

NDK变量中“d/program/android/ndk/ ”代表本机NDK安装路径，需要按照自己机器路径替换，配置好.bash_profile文件后，使用source .bash_profile命令使配置生效。

b.查看PATH环境变量中，是否配置了NDK安装路径，如果没有，请自行添加。

c.在Eclipse中配置NDK_BUILDER编译器

在工程名称上右击—>Properties—>Builder—>New，在弹出的对话框中填入如下的配置信息，根据个人安装环境配置：

其中Arguments中的”e/demo/android/JNIDemo/jni”表示你编译的项目的路径。

d.最后将配置的NDK_BUILD编译选项置为编译过程的最开始。

至此，完成NDK开发的全部配置编译过程。

6 参考资料

Android Android.mk 文件一点感悟

编写Android.mk中的LOCAL_SRC_FILES的终极技巧

Android.mk高级写法

Android.mk语法规范

在win7环境下使用cygwin+NDK实现JNI开发