android.mk中常见local变量解析

     local变量是用来向生成系统描述你的组件的。你应该在'include $(CLEAR_VARS)'和'include $(BUILD_XXXXX)'之间定义其中的一些变量。

1.LOCAL_PATH
   这个变量用来设置当前文件的路径。你必须在Android.mk的开始处定义它，比如：
    
    LOCAL_PATH := $(call my-dir)
   
   这个变量不会被$(CLEAR_VARS)消除，所以每个Android.mk仅需一个定义（以防你在
   同一个文件里定义几个组件）。
 
   
2.LOCAL_MODULE
   定义组件的名称。对于所有的组件名，它必须是唯一，且不能包含空格。
   在include $(BUILD_XXX）之前你必须定义它。
 
   这个组件名决定生成的文件（译者注：即库名）。比如，lib<foo>，即这个组件的名称
   为<foo>。但是在你的NDK生成文件（不管是Android.mk还是Application.mk)中
   你只能通过‘正常’的名称(如，<foo>)来引用其它的组件。
 
         
3.LOCAL_SRC_FILES
   用它来定义所有用来生成组件的源文件。仅须列出传给编译器的文件，因为
   生成系统会自动地计算它们的相互依赖关系。
 
   注意，所有文件名都是相对于LOCAL_PATH的，你可以用到路径组件（path component)
   如：
     LOCAL_SRC_FILES := foo.c \ (译者注：‘\’为连接符）
                         toto/bar.c

       
4.LOCAL_CPP_EXTENSION
   这是一个可选的变量，可用它来指明C++源文件的扩展名。默认情况下是'.cpp',
   但你可以改变它。比如：
   
     LOCAL_CPP_EXTENSION := .cxx

     
   
5.LOCAL_C_INCLUDES
   一个相对于相对于NDK*根*目录可选的路径名单，当编译所有的源文件（C,C++和汇编）时，
   它将被添加进include搜索路径。例如：
  
      LOCAL_C_INCLUDES := sources/foo
 
     或者甚至：
    
      LOCAL_C_INCLUDES := $(LOCAL_PATH)/../foo

6.LOCAL_CFLAGS
    一个可选的编译标记集，在生成C与C++源文件时，将解析它。
   
    对指定额外的宏定义或编译选项很有用。
              
    重要：不要试图改变你Android.mk里的optimization/debuggin level,通过
          在你的Android.mk里指定合适的信息，它将被自动处理，并使NDK生成
          调试时可用的有用的数据文件。
         
    注意：在android-ndk-1.5_r1，相应的标记（flags)只适用于C源文件，对C++
        源文件并不适用。为了适用于完整的Android生成系统的特性，已作了修
        正。（现在，你可以使用LOCAL_CPPFLAGS为C++文件指定标记）

for example!

LOCAL_CFLAGS += -O3 -fstrict-aliasing -fprefetch-loop-arrays
通过设定编译器操作，优化级别，-O0表示没有优化,-O1为缺省值，-O3优化级别最高
LOCAL_CFLAGS += -W -Wall
LOCAL_CFLAGS += -fPIC -DPIC
LOCAL_CFLAGS += -O2 -g -DADB_HOST=1 -Wall -Wno-unused-parameter
LOCAL_CFLAGS += -D_XOPEN_SOURCE -D_GNU_SOURCE -DSH_HISTORY
LOCAL_CFLAGS += -DUSEOVERLAY2

（现在，你可以使用LOCAL_CFLAGS为C和C++源文件指定标记）

7.LOCAL_STATIC_LIBRARIES
    一份static libraries组件的名单（以BUILD_STATIC_LIBRARY的方式生成），它将被
    连接到欲生成的组件上。这仅在生成shared library组件时有意义。（译者注：将指定
    的一个或多个static library module转化为一个shared library module)

8.LOCAL_SHARED_LIBRARIES
    一份该组件在运行期依赖于它的shared libraries *组件*。在连接时间(link time)里
    与及为该生成的文件嵌入相应的信息都要用到它。

    注意，它并不将这份组件名单添加入生成图表（build graph)。即，在你的Android.mk
    里，你仍应该将它们加入到你的应用程序要求的组件。

9.LOCAL_LDLIBS
    一份能在生成你的组件时用到的额外的连接器标记（linkerflags)的名单。在传递
    有“-l”前缀的特殊系统库的名称时很有用。比如，下面的语句会告诉连接器在装载
    时间（load time)里生成连接到/system/lib/libz.so的组件。

      LOCAL_LDLIBS := -lz

    若想知道在这个NDK版本可以连接哪些暴露的系统库（exposed system libraries)，
    请参见docs/STABLE-APIS。

10.LOCAL_ALLOW_UNDEFINED_SYMBOLS
    缺省值情况下，当尝试生成一个shared library遇到没有定义的引用时，会导致“undefined
    symbol”error。这对在你的源代码里捕捉bugs有很大的帮助。
   
    但是，因为一些原因你须要disable这个检查，将这个变量设置为'true’。注意，相应
    的shared library可能在运行期装载失败。

11.LOCAL_ARM_MODE
    缺省值情况下，ARM目标二进制将会以‘thumb’模式生成，这时每个指令都是16-bit宽的。
    如果你想强迫组件的object文件以‘arm’（32位的指令）的模式生成，你可以将这个变量
    定义为'arm'。即：

      LOCAL_ARM_MODE := arm

    注意，你也可以通过将‘.arm’后缀添加到源文件名字的后面指示生成系统将指定的
    源文件以arm模式生成。例如：
  

       LOCAL_SRC_FILES := foo.c bar.c.arm

    告诉生成系统总是以arm模式编译‘bar.c’，但根据LOCAL_ARM_MODE的值生成foo.c

    注意：在你的Application.mk里将APP_OPTIM设置为'debug',这也会强迫生成ARM二进制
    代码。这是因为工具链的调度器有bugs，它对thumb码的处理不是很好。

12.LOCAL_PRELINK_MODULE
Prelink利用事先链接代替运行时链接的方法来加速共享库的加载，它不仅可以加快起动速度，还可以减少部分内存开销，
是各种Linux架构上用于减少程序加载时间、缩短系统启动时间和加快应用程序启动的很受欢迎的一个工具。程序运行时的
动态链接尤其是重定位(relocation)的开销对于大型系统来说是很大的。
动态链接和加载的过程开销很大，并且在大多数的系统上, 函数库并不会常常被更动, 每次程序被执行时所进行的链接
动作都是完全相同的，对于嵌入式系统来说尤其如此。因此，这一过程可以改在运行时之前就可以预先处理好，即花一些时间
利用Prelink工具对动态共享库和可执行文件进行处理，修改这些二进制文件并加入相应的重定位等信息，节约了本来在程序
启动时的比较耗时的查询函数地址等工作，这样可以减少程序启动的时间，同时也减少了内存的耗用。
Prelink的这种做法当然也有代价：每次更新动态共享库时，相关的可执行文件都需要重新执行一遍Prelink才能保
证有效，因为新的共享库中的符号信息、地址等很可能与原来的已经不同了，这就是为什么 android framework代码一改动，
这时候就会导致相关的应用程序重新被编译。
这种代价对于嵌入式系统的开发者来说可能稍微带来一些复杂度，不过好在对用户来说几乎是可以忽略的。
－－－－－－－－－－－－－－－－－－－－
变量设置为false那么将不做prelink操作
LOCAL_PRELINK_MODULE := false
默认是需要prlink的，同时需要在 build/core/prelink-linux-arm.map 中加入
libhellod.so 0x96000000
这个map文件好像是制定动态库的地址的，在前面注释上面有一些地址范围的信息，注意库与库之间的间隔数，
如果指定不好的话编译的时候会提示说地址空间冲突的问题。另外，注意排序，这里要把数大的放到前面去，
按照大小降序排序。
解析 LOCAL_PRELINK_MODULE 变量
build/core/dynamic_binary.mk:94:ifeq ($(LOCAL_PRELINK_MODULE),true)
ifeq ($(LOCAL_PRELINK_MODULE),true)
$(prelink_output): $(prelink_input) $(TARGET_PRELINKER_MAP) $(APRIORI)
$(transform-to-prelinked)
transform-to-prelinked定义：
./build/core/definitions.mk:1002:define transform-to-prelinked
define transform-to-prelinked
@mkdir -p $(dir $@)
@echo "target Prelink: $(PRIVATE_MODULE) ($@)"
$(hide) $(APRIORI) \
--prelinkmap $(TARGET_PRELINKER_MAP) \
--locals-only \
--quiet \
$< \
--output $@
endef
./build/core/config.mk:183:APRIORI := $(HOST_OUT_EXECUTABLES)/apriori$(HOST_EXECUTABLE_SUFFIX)
prelink工具不是常用的prelink而是apriori，其源代码位于” <your_android>/build/tools/apriori”
参考文档：
动态库优化——Prelink（预连接）技术
http://www.eefocus.com/article/09-04/71629s.html

 13.LOCAL_JAVA_LIBRARIES 加入jar包