Android.mk的写法

总结一下Android.mk的写法，供以后使用。http://bbs.9ria.com/thread-262936-1-1.html
　　例子
　　可以先看一个例子：
　　plain代码

1. LOCAL_PATH:=$(call my-dir)
   
2. 
   
3. 　　include $(CLEAR_VARS)
   
4. 　　LOCAL_SRC_FILES:= \
   
5. 　　NmpMediaBase.cpp
   
6. 　　LOCAL_CPPFLAGS+= -Wall -W -Wno-format \
   
7. 　　-Os -O2 -fmessage-length=0 -MMD -MP -DSILENT
   
8. 　　LOCAL_C_INCLUDES+= \
   
9. 　　$(LOCAL_PATH)/3rdpart/3901/include \
   
10. 　　/opt/ali_sdk/staging/usr/include/ali/nmp/
    
11. 　　LOCAL_SHARED_LIBRARIES := -lstdc++ libstlport -lpthread
    
12. 　　LOCAL_LDLIBS:= -L./ -ljson -lc -ldl -lstdc++ -lm
    
13. 　　#LOCAL_CXX := arm-linux-gnueabi-g++
    
14. 　　#LOCAL_CPP_FEATURES += exceptions
    
15. 　　LOCAL_CPPFLAGS += -fexceptions -fpermissive
    
16. 　　LOCAL_MODULE:=mediabase
    
17. 　　LOCAL_MODULE_TAGS := optional
    
18. 　　include $(BUILD_EXECUTABLE)

复制代码

　　变量解析：
　　LOCAL_PATH:=$(call my-dir)
　　LOCAL_PATH表示此时位于工程目录的根目录中，(call my-dir)的功能由编译器提供，被用来返回当前目录的地址(这里的当前目录里包含Android.mk这个文件本身)。
　　include $(CLEAR_VARS)
　　CLEAR_VARS这个变量由编译器提供，并且指明了一个GNU Makefile文件，这个功能会清理掉所有 以LOCAL_开头的内容 (例如 LOCAL_MODULE、LOCAL_FILES、LOCAL_STATIC_LIBRARIES等)，除了LOCAL_PATH。这句话是必须的，因为如果所有的变量都是全局的，所有的可控的编译文件都需要在一个单独的GNU中被解析并执行。
　　LOCAL_SRC_FILES变量必须包含一个C、C++或者java源文件的列表，这些会被编译并聚合到一个模块中。只要列出要传递给编译器的文件，因为编译系统自动计算依赖。注意源代码文件名称都是相对于 LOCAL_PATH的，你可以使用路径部分，例如：
　　LOCAL_SRC_FILES := foo.c toto/bar.c\
　　Hello.c
　　文件之间可以用空格或Tab键进行分割,换行请用"\"，如果是追加源代码文件的话，请用LOCAL_SRC_FILES +=。
　　注意：可以LOCAL_SRC_FILES := $(call all-subdir-java-files)这种形式来包含local_path目录下的所有java文件。
　　LOCAL_MODULE 变量必须被定义，用来区分android.mk中的每一个模块。文件名必须是唯一的，不能有空格。注意，这里编译器会为你自动加上一些前缀和后缀，来保证文件是一致的。
　　BUILD_EXECUTABLE这个变量是由系统提供的，并且制定给GNU Makefile的脚本，它可以收集所有你定义的“include $(CLEAR_VARS)”中以LOCAL_开头的变量，并且决定哪些要被编译，哪些应该做的更加准确。表示将编译生成一个可执行文件。
　　我们同样也可以使用:
　　BUILD_SHARED_LIBRARY来生成一个动态库;
　　BUILD_STATIC_LIBRARY来生成一个静态的库;
　　BUILD_PACKAGE来生成一个APK;
　　LOCAL_OVERRIDES_PACKAGES此变量可以使其他的模块不加入编译，如源码中DeskClock的android.mk有LOCAL_OVERRIDES_PACKAGES := AlarmClock，使 AlarmClock不会加入到编译系统中，不会生成 AlarmClock.apk。
　　LOCAL_STATIC_LIBRARIES: 表示该模块需要使用哪些静态库，以便 在编译时进行链接。
　　LOCAL_SHARED_LIBRARIES: 表示模 块在运行时 要依赖的共享库(动态库)，在链接时就需要，以便在生成文件时嵌入其相应的信息。
　　注意：它不会附加列出的模块到编译图，也就是仍然需要在Application.mk 中把它们添加到程序要求的模块中。
　　LOCAL_LDLIBS: 编译模块时要使用的附加的链接器选项。这对于使用‘-l’前缀传递指定库的名字是有用的。
　　例如，LOCAL_LDLIBS := -lz表示告诉链接器生成的模块要 在加载时刻 链接到/system/lib/libz.so
　　可查看 docs/STABLE-APIS.TXT 获取使用 NDK发行版能链接到的开放的系统库列表。
　　LOCAL_LDLIBS ：链接的库不产生依赖关系，一般用于不需要重新编译的库，如库不存在，则会报错找不到。且貌似只能链接那些存在于系统目录下本模块需要连接的库。如果某一个库既有动态库又有静态库，那么在默认情况下是链接的动态库而非静态库。
　　如：LOCAL_LDLIBS += -lm –lz –lc -lcutils –lutils –llog
　　如果需要指定链接库的路径则直接在后面写 -L再加路径即可
　　LOCAL_SHARED_LIBRARIES 会生成依赖关系，当库不存在时会去编译这个库。
　　LOCAL_LDFLAGS：这个编译变量传递给链接器一个一些额外的参数，比如想传递而外的库和库路径给ld，或者传递给ld linker的一些链接参数，-On，-EL{B}(大小端字节序)，那么就要加到这个上面，如：
　　LOCAL_LDFLAGS += -L$(LOCAL_PATH)/lib/ -lHWrecog –EB{EL} –O{n} …
　　或者直接加上绝对路径库的全名：
　　LOCAL_LDFLAGS += $(LOCAL_PATH)/lib/libHWrecog.a –EB{EL} –O{n}
　　include $(call all-subdir-makefiles)
　　它的作用就是包含所有子目录中的Android.mk文件
　　如果需要编译的模块比较多，我们可能会将对应的模块放置在相应的目录中，
　　这样，我们可以在每个目录中定义对应的Android.mk文件(类似于上面的写法)，
　　最后，在根目录放置一个Android.mk文件，加入include $(call all-subdir-makefiles)
　　TARGET_ARCH指架构中CPU的名字已经被android开源代码明确指出了。这里的ARM包含了任何ARM-独立结构的架构，以及每个独立的CPU的版本。
　　TARGET_PLATFORM: Android.mk 解析的时候，目标 Android 平台的名字.

1. 　　android-3 -> Official Android 1.5 system images
   
2. 　　android-4 -> Official Android 1.6 system images
   
3. 　　android-5 -> Official Android 2.0 system images

复制代码

　 　TARGET_ARCH_ABI: 暂时只支持两个 value，armeabi 和 armeabi-v7a
　　TARGET_ABI: 目标平台和 ABI 的组合
　　LOCAL_C_INCLUDES: 可选变量，表示头文件的搜索路径。默认的头文件的搜索路径是LOCAL_PATH目录。
　　LOCAL_MODULE_PATH 和 LOCAL_UNSTRIPPED_PATH
　　在 Android.mk 文件中， 还可以用LOCAL_MODULE_PATH 和LOCAL_UNSTRIPPED_PATH指定最后的目标安装路径.
　　不同的文件系统路径用以下的宏进行选择：
　　TARGET_ROOT_OUT：表示根文件系统。
　　TARGET_OUT：表示 system文件系统。
　　TARGET_OUT_DATA：表示 data文件系统。
　　用法如：LOCAL_MODULE_PATH :=$(TARGET_ROOT_OUT)
　　LOCAL_JNI_SHARED_LIBRARIES：定义了要包含的so库文件的名字，如果程序没有采用jni，不需要
　　LOCAL_JNI_SHARED_LIBRARIES := libxxx 这样在编译的时候，NDK自动会把这个libxxx打包进apk; 放在yourapk/lib/目录下
　　LOCAL_CFLAGS可选的编译器选项， 在编译C代码文件的时候使 用。这可能是有用的，指定 一个附加的包含路径(相对于NDK的顶层目录) ， 宏定义，或者编译选项。 注意：不要在Android.mk中改变optimization/debugging级别，只要在Application.mk中指定合适的信息，就会自动地为你处理这个问题，在调试期间，会让NDK自动生成有用的数据文件。
　　LOCAL_CXXFLAGS与LOCAL_CFLAGS相同，针对C++源文件。

　　LOCAL_CPPFLAGS与LOCAL_CFLAGS相同，但是对C和C++sourcefiles都适用。

　　NDK提供的函数宏:
　　my-dir:返回当前 Android.mk 所在的目录的路径，相对于 NDK 编译系统的顶层。这是有用的，在 Android.mk 文件的开头如此定义：
　　LOCAL_PATH := $(call my-dir)
　　all-subdir-makefiles: 返回一个位于当前'my-dir'路径的子目录中的所有Android.mk的列表。
　　this-makefile: 返回当前Makefile 的路径(即这个函数调用的地方)
　　parent-makefile: 返回调用树中父 Makefile 路径。即包含当前Makefile的Makefile 路径。
　　grand-parent-makefile：返回调用树中父Makefile的父Makefile的路径
　　在Android.mk中，“:=”是赋值的意思;“+=”是追加的意思;“$”表示引用某变量的值。
　　Android.mk给变量赋值，同时用的“:=”和“=”，他们分别代表什么意思呢?
　　“:=” 的意思是，它右边赋得值如果是变量，只能使用在这条语句之前定义好的，而不能使用本条语句之后定义的变量;
　　“=”，当它的右边赋值是变量时，这个变量的定义在本条语句之前或之后都可以;
　　常见错误及解决办法：
　　fatal error: string: No such file or directory

　　解决办法：增加Application.mk 写 APP_STL :=gnustl_static

　　error: 'pthread_rwlock_t' does not name a type

　　在Application.mk中添加改写application.mk文件，把版本改成9或更高，APP_PLATFORM := android-9 //对应2.3.1;

　　在Android API < 9时，采用android NDK编译代码是不支持pthread_rwlock_t结构体的。
　　Ndk编译curl：
　　下载源码： http://curl.haxx.se/download.html
　　./configure --host=arm-linux CC=arm-linux-gnueabi-gcc --prefix=//home/usrhome/johnny.he/androidworkspace/curl_install
　　make; make install