LOCAL_PATH

LOCAL_PATH 每个模块都在Android.mk里定义，表示模块所在目录。

此变量用于指定当前文件的路径。必须在 Android.mk 文件开头定义此变量。以下示例演示了如何定义此变量：

LOCAL_PATH := $(call my-dir)

CLEAR_VARS 所指向的脚本不会清除此变量。因此，即使 Android.mk 文件描述了多个模块，您也只需定义此变量一次。

LOCAL_PATH的作用

有人就问了，在本Android.mk中又没有使用到LOCAL_PATH，为什么先 要定义这么一个变量呢？为什么规定必须放在所有的include $(CLEAR_VARS)之前呢？

哪里在使用LOCAL_PATH

在Android.mk中我们发现有LOCAL_SRC_FILES := acp.的定义，NDK文件中对LOCAL_SRC_FILES 的说明如下：

This is a list of source files that will be built for your module. Only list the files that will be passed to a compiler, since the build system automatically computes dependencies for you.
Note that source files names are all relative to LOCAL_PATH and you can use path components.

因此在定义LOCAL_SRC_FILES 时已经间接的使用到了LOCAL_PATH变量，即定义LOCAL_SRC_FILES是用的基于当前路径的相对路径。

为什么必须在$(CLEAR_VARS)之前

我们接着看看为什么LOCAL_PATH的定义必须要放到所有的include $(CLEAR_VARS)之前。

LOCAL_PATH通过调用my-dir函数来获取当前的路径，my-dir函数的定义位于core/definitions.mk文件：

请注意，这里明确的说明了LOCAL_PATH的定义必须要放在任何include (CLEAR_VARS)语句之前，如果不这么做的话，编译就直接报错，停止不干了。

可是它是怎么判断LOCAL_PATH的定义是在任何include(CLEAR_VARS)语句之前呢，我们看到有这么一句话：

$(if $(filter $(CLEAR_VARS),$(md_file_))  

这个判断语句是个关键，我们先看看CLEAR_VARS变量的定义，在build/core/config.mk中有如下明确的定义：

CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk  

而BUILD_SYSTEM的定义在build/core/main.mk文件中：

BUILD_SYSTEM := $(TOPDIR)build/core

紧接着：

TOPDIR :=  

即TOPDIR为android源码的根目录， BUILD_SYSTEM= build/core， 所以CLEAR_VARS变量的值就为build/core/clear_vars.mk，当然这个也是相对于Android源码根路径。

得到了CLEAR_VARS变量的值，我们再回到my-dir函数中。

根据gnu make定义，gnu make 会自动将所有读取的makefile路径都会加入到MAKEFILE_LIST变量中，而且是按照读取的先后顺序添加。

那么，在运行本makefile文件时，$(MAKEFILE_LIST) 字符串中最后一个makefile肯定是最后读取的makefile，即$(lastword $(MAKEFILE_LIST))则会返回build/tools/acp/Android.mk，此字符串经过$(eval md_file_ := (lastword(MAKEFILE_LIST))运算，赋值给了临时变量md_file_。

判断md_file_中是否包含CLEAR_VARS变量的值$(if $(filter $(CLEAR_VARS),$(md_file_))，肯定也就会返回失败，再通过$(patsubst %/,%,$(dir $(md_file_)))函数，则会得到当前路径，即build/tools/acp

如果我们在include $(CLEAR_VARS)之后，再调用my-dir函数，那么$$(lastword $$(MAKEFILE_LIST))肯定就会返回$(BUILD_SYSTEM)/clear_vars.mk，同时，$(patsubst %/,%,$(dir $(md_file_)))也就会返回$(BUILD_SYSTEM)的值build/core，而不是当前的路径build/tools/acp。

这么一来得到的LOCAL_PATH的值就是错误的值，依赖LOCAL_PATH的其他变量也就更加不可能是正确的了！所以说 ，LOCAL_PATH必须要在任何including $(CLEAR_VARS))之前定义 。