Android Makefile常用函数简介(不定期更新)

Android Makefile常用函数简介(不定期更新)

Qidi 2017.02.20 Markdown & Haroopad

---

CSDN的Markdown编辑器对美元符号（$）和百分号（%）的支持好像有问题。下面正文中的括号前都有美元符号（$），我现在已经为这些美元符号额外添加转义符号了。如果还有没显示出来的，烦请告知。谢谢。
而且CSDN对特定关键字会自动添加超链接，比如Android、java等，这也影响了Markdown文本的正确显示。
下次再在CSDN发表博客，我还是换回普通编辑器吧。

---

word N, TEXT
作用：取出TEXT中第N个单词
示例：$(word 3, aaa bbb ccc) 结果为 ccc
出处：main.mk:26:#TOP := $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))

words TEXT
作用：返回TEXT中的单词数目
示例：$(words aaa bbb ccc) 结果为 3
出处：main.mk:26:#TOP := $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))

dir FILENAME
作用：返回FILENAME文件的目录
示例：$(dir core/main.mk) 结果为 core/
出处：main.mk:26:#TOP := $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))

patsubst FROM, TO, FILELIST
作用：将FILELIST中符合模式（pattern）FROM的文件名或字符串替换为TO模式那样的文件名或字符串
示例：$(patsubst %c, %.o, aaa.c bbb.c) 结果是 aaa.o bbb.o
出处：main.mk:27:#TOP := $(patsubst %/, %, $(TOP))

lastword TEXT
作用：返回TEXT文本中的最后1个单词。相当于$(word $(words TEXT), TEXT)
示例：$(lastword aaa bbb ccc) 结果为 ccc
出处：clear_cars.mk:377:MAKEFILE_LIST := $(lastword $(MAKEFILE_LIST))

filter PATERN, TEXT
作用：取出TEXT中符合PATERN模式的字符串
示例：$(filter a%, aaa abc bbb ccc) 结果为 aaa abc
出处：envsetup.mk:252:ifneq ($(filter　 dax%, $(TARGET_PRODUCT)), )

filter-out PATTERN, TEXT
作用：取出TEXT中除了符合PATTERN模式的其余字符串
示例：$(filter-out aaa, aaa bbb ccc) 结果为 bbb ccc
出处： Android.mk:52:LOCAL_SRC_FILES := $(filter-out DolbySoundTile.java DolbySoundController.java, $(LOCAL_SRC_FILES))

strip TEXT
作用：去掉TEXT中的空格
示例：$(strip aaa bbb ccc) 结果为 aaabbbccc
出处：dolby-product.mk:49:ifneq ($(strip $(DOLBY_MONO_SPEAKER)), )

findstring TARGET, TEXT
作用：在TEXT字符串中查找并返回TARGET字符串，若不存在则返回空
示例：$(findstring aaa, aaa bbb ccc) 结果为 aaa
出处：Android.mk:14:ifeq ($(findstring arm, $(TARGET_ARCH)), arm)

error TEXT
作用：打印内容为TEXT的错误消息，并结束makefile运行
示例：$(error “Fatal error occured.”)
出处： Android.mk:18:$(error “Unsupported architecture for DAP1: $(TARGET_ARCH)”)

---

【补充说明】

很多时候我们还会看到有all-makefiles-under、all-c-files-under、all-cpp-files-under、all-java-files-under、find-subdir-files、my-dir、inherit-product、inherit-device等函数的调用。举个例子：LOCAL_SRC_FILES := $(call all-java-files-under, src)这个调用就是要查找出src/目录下的所有java源文件，并将这些源文件的名字添加到LOCAL_SRC_FILES这个变量中。

这些makefile函数其实都是在build/core/*.mk文件中定义的，通常以define关键字开头。如果我们想知道它们的作用是什么，可以直接去makefile文件中查看。在build/core/目录下使用命令grep -rn ^define\ all-java-files-under就可以轻松查找到相应命令的定义。

比如all-java-files-under就是在build/core/definitions.mk文件中定义的。定义内容如下：

##########################################################
## Find all of the java files under the named directories.
## Meant to be used like:
##    SRC_FILES := $(call all-java-files-under, src tests)
##########################################################
define all-java-files-under
$(call all-named-files-under, *.java, $(1))
endef