Android NDK开发指南---Application.mk文件

简介：
-----------------------------
要将C\C++代码编译为SO文件，光有Android.mk文件还不行，还需要一个Application.mk文件。
本文档是描述你的Android应用程序中需要的本地模块的Application.mk的语法使用，要明白如下。


Application.mk目的是描述在你的应用程序中所需要的模块(即静态库或动态库)。


Application.mk文件通常被放置在$PROJECT/jni/Application.mk下，$PROJECT指的是您的项目。


另一种方法是将其放在顶层的子目录下：
$NDK/apps目录下，例如：
$NDK/apps/<myapp>/Application.mk


<myapp>是一个简称，用于描述你的NDK编译系统的应用程序（这个名字不会生成共享库或者最终的包）


下面是Application.mk中定义的几个变量。


APP_PROJECT_PATH
这个变量是强制性的，并且会给出应用程序工程的根目录的一个绝对路径。这是用来复制或者安装一个没有任何版本限制的JNI库，从而给APK生成工具一个详细的路径。


APP_MODULES
这个变量是可选的，如果没有定义，NDK将由在Android.mk中声明的默认的模块编译，并且包含所有的子文件（makefile文件）
如果APP_MODULES定义了，它不许是一个空格分隔的模块列表，这个模块名字被定义在Android.mk文件中的LOCAL_MODULE中。注意NDK会自动计算模块的依赖


注意：NDK在R4开始改变了这个变量的行为，再次之前：
 - 在您的Application.mk中，该变量是强制的
 - 必须明确列出所有需要的模块


APP_OPTIM
这个变量是可选的，用来定义“release”或"debug"。在编译您的应用程序模块的时候，可以用来改变优先级。


“release”模式是默认的，并且会生成高度优化的二进制代码。"debug"模式生成的是未优化的二进制代码，但可以检测出很多的BUG，可以用于调试。


注意：如果你的应用程序是可调试的（即，如果你的清单文件中设置了android:debuggable的属性是"true"）。默认的是"debug"而不是"release"。这可以通过设置APP_OPTIM为"release"来将其覆盖。


注意：可以在"release"和"debug"模式下一起调试，但是"release"模式编译后将会提供更少的BUG信息。在我们清楚BUG的过程中，有一些变量被优化了，或者根本就无法被检测出来，代码的重新排序会让这些带阿弥变得更加难以阅读，并且让这些轨迹更加不可靠。


APP_CFLAGS
当编译模块中有任何C文件或者C++文件的时候，C编译器的信号就会被发出。这里可以在你的应用中需要这些模块时，进行编译的调整，这样就不许要直接更改Android.mk为文件本身了


重要警告：+++++++++++++++++++++++++++++++++++++++++++++++ + +
+
+ 在这些编制中，所有的路径都需要于最顶层的NDK目录相对应。
+ 例如，如果您有以下设置：
+
+sources/foo/Android.mk
+sources/bar/ Android.mk
+ 编译过程中，若要在foo/Android.mk中指定你要添加的路径到bar源代码中，
+ 你应该使用
+ APP_CFLAGS += -Isources/bar
+ 或者交替：
+ APP_CFLAGS += -I $（LOCAL_PATH )/../bar
+
+ 使用'-l../bar/'将不会工作，以为它将等同于"-l$NDK_ROOT/../bar"
++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++
注意：在Android的NDK 1.5_r1，只适用于C源文件，而不适合C++。
这已得到纠正，以建立完整相匹配的Andr??oid系统。 


APP_CXXFLAGS
APP_CPPFLAGS的别名，已经考虑在将在未来的版本中废除了


APP_CPPFLAGS
当编译的只有C++源文件的时候，可以通过这个C++编译器来设置


注意：在Android NDK-1.5_r1中，这个标志可以应用于C和C++源文件中。并且得到了纠正，以建立完整的与系统相匹配的Android编译系统。你先可也可以使用APP_CFLAGS来应用于C或者C++源文件中。
建议使用APP_CFLAGS


APP_BUILD_SCRIPT
默认情况下，NDK编译系统会在$(APP_PROJECT_PATH)/jni目录下寻找名为Android.mk文件：
$(APP_PROJECT_PATH)/jni/Android.mk


如果你想覆盖此行为，你可以定义APP_BUILD_SCRIPT来指定一个备用的编译脚本。一个非绝对路径总是被解释为相对于NDK的顶层的目录。


APP_ABI
默认情况下，NDK的编译系统回味"armeabi"ABI生成机器代码。喜爱哪个相当于一个基于CPU可以进行浮点运算的ARMv5TE。你可以使用APP_ABI来选择一个不同的ABI。


比如：为了在ARMv7的设备上支持硬件FPU指令。可以使用
APP_ABI := armeabi-v7a


或者为了支持IA-32指令集，可以使用
APP_ABI := x86


或者为了同时支持这三种，可以使用
APP_ABI := armeabi armeabi-v7a x86


APP_STL
默认情况下，NDK的编译系统为最小的C++运行时库（/system/lib/libstdc++.so）提供C++头文件。
然而，NDK的C++的实现，可以让你使用或着链接在自己的应用程序中。
例如：
APP_STL := stlport_static    --> static STLport library
APP_STL := stlport_shared    --> shared STLport library
APP_STL := system            --> default C++ runtime library


下面是一个Application.mk文件的示例：
APP_PROJECT_PATH := <path to project>