首页 > 代码库 > 新随笔
新随笔
本文档从NDK安装目录下的说明文档翻译而来,位置:$NDK/docs/APPLICATION-MK.html 1 概述 Application.mk用来描述你的工程下的native模块, 一般放在$PROJECT/jni/Application.mk, 其中$PROJECT表示你的工程目录,这样就可以被ndk-build脚本文件找到.(注:在这种方式下,进入jni目录,即$PROJECT/jni/,然后执行ndk-build,就可以直接编译jni生成.so文件了). 还有另外一种方法就是将Application.mk文件放在$NDK/app/<myapp>/Application.mk,其中$NDK为NDK的安装目录,<myapp>为你的应用程序名.在这种方式下,进入$NDK安装目录,然后输入make APP=<name>,即可编译你的JNI代码.此种方法是ndk-r4之前的方法,虽然出于兼容的原因目录还支持,但是不建议使用此种方法,因为第一种方法简单,且方便. 在Application.mk文件内定义了一些变量: APPPROJECTPATH 此变量值必须是你工程根目录的绝对路径.这用于指定JNI生成的.so文件安装路径或拷贝路径. 注:此变量对于第一种方法是可选了,但对于第二种方法却是必须的. APPMODULES 模块名 此变量是可选的,如果没有在此文件中定义,则默认由Android.mk文件决定. 如果在Application.mk文件中定义此变量,那么它必须是一串由空格相隔的模块名列表,并且与Android.mk文件中的LOCALMODULE变量定义保持一致.需要注意地是,NDK会自动计算模块所需要的依赖文件。 注:此变量在NDK R4版本之前是在Application.mk中是必须的,所有模块必须显式地列出. APPOPTIM 优化选项 此变量是可选的,其值可以为‘release‘或‘debug‘.此变量用来修改优先等级.默认情况下为release.在release模式下,将编译生成被优化了的二进制的机器码,而debug模块用来生成便于调试的未被优化的二进制机器码。 需要注意地是,如果你的程序在manifest文件中的节点下<application>已经设置了android:debuggable属性为"true",则Apllication.mk文件此变量的默认值则为‘debug‘而不是‘release‘,可以在Application.mk文件中将此变量值设置为‘release‘而覆盖其值. 虽然在两种模块下都可以调试,但是release模式下提供更少的调试信息,比如:一些变量被优化从而不能被检查,代码重组,及跟踪。 APPCFLAGS 编译选项 可以在Application.mk文件中修改此编译选项参数,此参数可以覆盖Android.mk文件中的相同定义,从而不必去Android.mk文件中修改. 需要注意地是,这个选项里的路径必须是以顶层NDK目录为相对路径,如存在以下两个文件: sources/foo/Android.mk sources/bar/Android.mk 如果在foo/Android.mk文件中想要添加bar目录,那么得这样便用: APPCFLAGS += -Isources/bar 如果这样使用: APPCFLAGS += -I$(LOCALPATH)/../bar 将会变成‘-I$NDKROOT/../bar‘,从而出现并不是你想要的结果. 在android-ndk-1.5r1时,此选项中只在C代码中被支持,而C++不支持,不过现在已经被纠正了. APPCXXFLAGS APPCPPFLAGS的别名,将来此变量将会被抛弃。 APPCPPFLAGS C++代码的编译选项。在android-ndk-1.5r1版本中,此变量只适用于C++,但是现在可以同时适用于C和C++。 APPBUILDSCRIPT 在默认情况下,NDK会在jni目录下查找Android.mk文件并使用它,如果你想修改它,那么在此变量中你可以指定一个你自己的脚本来执行,路径还是以工程顶层目录为相对路径. APPABI 在默认情况下,NDK会使用‘armeabi‘ ABI 来生成二进制机器码,这是基于ARMv5TE的浮点运算CPU,这可以通过使用此变量来选项不同的ABI(Application Binary Interface).
例如:支持基于armv7 FPU指令集的设备: APPABI := armeabi-v7a 支持IA-32指令集: APPABI := x86 同时支持三种: APPABI := armeabi armeabi-v7a x86 从NDK-r7版本后,同时支持三种还可以这样写: APPABI := all 有关ABI更详细的内容请参考文档:docs/CPU-ARCH-ABIS.html APPSTL C++标准库 在默认情况下,NDK通过Androoid自带的最小化的C++运行库(system/lib/libstdc++.so)来提供标准C++头文件.然而,NDK提供了可供选择的C++实现,你可以通过此变量来选择使用哪个或链接到你的程序。 APPSTL := stlportstatic –> static STLport library APPSTL := stlportshared –> shared STLport library APPSTL := system –> default C++ runtime library 更多详细内容请参考文档docs/CPLUSPLUS-SUPPORT.html。 APPGNUSTLFORCECPPFEATURES 在先前的NDK版本中,当使用GNU libstdc++ runtime运行库(通过设置APPSTL变量为gnustlstatic或gnustlshared)都会强制支持异常和RTTI,在有些极少情况下可能会出现问题,同时会使生成的机器码包含不必须的内容。 这种问题在NDK r7b中得到解决,但是这也意味着如果你真的需要支持异常和RTTI 的话,则必须显式声明。要么通过APPCPPFLAGS,要么通过LOCALCPPFLAGS,或LOCALCPPFEATURES。本变量就是为了解决此问题的. 有两个选项供选择,也可同时都选择. exceptions -> 强制所有模块支持异常. rtti -> 强制所有模块支持rtti. 例如: APPGNUSTLFORCECPPFEATURES := exceptions rtti 注意:此变量是过滤变量,将来有可能不支持.所以建议不使用此变量.
新随笔