[转载]Android.mk 小细节（LOCAL_CFLAGS 、BUILD_PREBUILT） 版权声明：本文为CSDN博主「kc专栏」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。原文链接：https://blog.csdn.net/kc58236582/article/details/49795865

[转载]makefile 中竖线 “|” 管道符的作用 版权声明：本文为CSDN博主「_Modest_」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。原文链接：https://blog.csdn.net/yangjizhen1533/article/details/113681130

[转载]linux – bash / Makefile中双符号的意思是什么？ 暂无简介

Make--(4)命令 make命令实质上就是一个单行shell脚本。实际上，make会获取每行命令并将它传递给subshell去执行。事实上，make会进行优化，make会通过在每个命令行中扫描shell特殊字符来进行此项检查。如果不存在任何shell特殊字符，make就会直接执行此命令，而不会将此命令传递给subshell去执行。make默认使用/bin/sh这个shell。如果需要变更，可以通过在makefile中明确设定SHELL这个变量。

Make--(2)变量与宏 一个变量名称几乎可以由任何字符组成，包括大部分的标点符号。即使是空格也可以使用，但请不要这样做。事实上，只有：、#和=等字符不允许使用在变量名称中。请注意，变量名称是区分大小写的。建议使用的命名习惯：当变量用来表示用户在命令行上或环境中所自定义的常数时，习惯上全部以大写来命名，单词之间用下划线隔开。至于只在makefile中出现的内部变量，则全部用小写来编写其名称，单词之间以下划线符号隔开。内含用户自定义函数的变量以及宏都会以小写来编写其名称，单词之间以破折号（-）隔开。1.自动变量自动变量含义$@ 工作目标的文件名$%档案文件成员（archive member）结构中的文件名元素。$<第一个必要条件的文件名$?时间戳在工作目标（的时间戳）之后的所有必要条件，并以空格隔开这些必要条件$^所有必要条件的文件名，并以空格隔开这些文件名。这份列表已删掉重复的文件名，因为对大多数的应用而言，比如编译、复制等，并不会用到重复的文件名$+ 如同$^，代表所有必要条件的文件名，并以空格隔开这些文件名。不过，$+包含重复的文件名。$*工作目标的主文件名。一个文件名称是由两部分组成：主文件名（stem）和扩展名（suffix）2. 变量的类型一般来说，以变量来代表外部程序是一个不错的注意，这让makefile的用户较容易针对他们特有的环境来改写makefile。变量可用来保存简单的常数，也可用来存放自定义的命令序列。例如下面的设定可用来汇报尚未使用的磁盘空间:DF = df AWK =awk free-space := $(DF) . | $(AWK) 'NR == 2 {print $$4}'make的变量有两种类型：经简单扩展的变量（simply expanded variable）以及经递归扩展的变量（recursively expanded variable）。经简单扩展的变量使用:=赋值运算符来定义一个经简单扩展的变量，如MAKE_DEPEND := $(CC) -M一旦make从makefile中读进该变量的定义语句，赋值运算符的右边部分会立刻被扩展。赋值运算符的右边部分只要出现make变量的引用就会被扩展，而扩展后所产生的的文本则会被存储成该变量的值。上面的变量被扩展之后就变成下面这样gcc -M然而，如果上面的CC变量尚未定义，则变量被扩展后将变成<space>-M未被定义的变量将被扩展为空值经递归扩展的变量直接使用=来定义，如MAKE_DEPEND = $(CC) -M ... # 稍后 CC = gccmake在读取变量时只会将=号右边的值赋值给变量，不会做任何的展开的动作，展开的动作会被延迟到该变量被使用的时候才进行。这样，当MAKE_DEPEND被使用的时候，即使CC并未定义，MAKE_DEPEND在脚本的值也会被扩展成gcc -M2.1 其他的赋值类型条件赋值?=此运算只会在变量的值尚不存在的状况下进行变量要求赋值的动作。附加运算符+=此运算符会将文本附加到变量里。当递归变量被使用时，赋值运算符右边部分的值会在"不影响变量中原有值的状况下"被附加到变量里。3. 宏变量适合用来存储单行形式的值，可是对于多行形式的值，例如命令脚本，如果我们想在不同的地方执行它，该怎么办？在GNU make中，我们可以通过define指令以创建“封装命令序列”（canned sequence）的方式来解决此问题，在这里简称为宏。例如，define build_target_with_subfeature_country @echo build_target_with_subfeature_country...... $(call build_target,$(filter $(TARGETS),$(subst _, ,$(1))),$(filter $(SUBFEATURE),$(subst _, ,$(1))),$(filter $(COUNTRY),$(subst _, ,$(1)))) endef define指令后面跟着变量名称以及一个换行符号。变量的主体包含了所有命令序列（每一行命令都必须前置一个Tab符号）直到ended关键字出现为止，endef关键字必须自成一行。在echo命令前置了一个@字符。当执行命令脚本时，前置@字符的命令不会被make输出。因此，当我们运行echo命令本身，只会输出该命令的输出。如果在宏内部使用@前缀，这个前缀字符只会影响使用到它的命令行。然而，如果将这个前缀字符用在宏引用上，则整个宏主体都会被隐藏起来。4. 何时扩展变量当make运行时。它会以两个阶段来完成它的工作。第一个阶段，make会读进makefile以及被引入的任何其他makefile。这个时候，其中所定义的变量和规则会被加载进make的内部数据库，而且依存图也会被建立起来。第二个阶段，make会分析依存图并且判断需要更新的工作目标，然后执行脚本以完成所需要的更新动作。当make在处理递归变量或define指令的时候，会将变量里的每一行或宏的主体存储起来，包括换行符号，但不会予以扩展。宏定义里的最后一个换行符号并不会被存储成宏的一部分；否则，宏被扩展时make会读进一个额外的换行符号。当宏被扩展时，make会立即扫描被扩展的文本中是否存在宏或变量的引用，如果存在就予以扩展，如此递归进行下去。如果宏是在命令脚本的语境中被扩展的，则宏主体的每一行都会被插入一个前导的跳格符（Tab）。下面是用来处理“makefile中的元素何时被扩展”的准则：对于变量赋值，make会在第一阶段读进该行时，立即扩展赋值运算符左边的部分。=和？=的右边部分会被延后到它们被使用的时候扩展，并且在第二阶段进行。:=的右边部分会被立即扩展如果+=的左边部分原本就被定义成一个简单变量，+=的右边部分就会被立即扩展，否则，它的求值动作会被延后。对于宏定义（使用define指令），宏的变量名称会被立即扩展，宏的主体会被延后到被使用的时候扩展对于规则，工作目标和必要条件总是会被立即扩展，然而命令总是会被延后扩展定义何时扩展a何时扩展ba = b立即延后a ?= b立即延后a := b立即立即a += b立即延后或立即define ab...endef立即延后一个通则是总是先定义变量和宏，然后再使用它们。尤其是，在工作目标或必要条件中使用变量时，就需要在使用变量之前予以定义。5. 工作目标与模式的专属变量在makefile运行期间，变量通常只有一个值。对需要经过两个处理阶段的makefile来说是这样没错。第一个阶段，make读进makefile之后，会对变量进行赋值和扩展的动作并建立依存图。第二个阶段，make会分析以及遍历依存图。所以，等到make指令命令脚本的时候，所有的变量都已经处理完毕了。但是如果我们想为特定的规则或模式重新定义变量，该怎么办？例如，现在我们想要编译一个需要额外命令行选项-DUSE_NEW_MALLOC=1的文件，但是其他的编译项目并不需要这个额外的命令行选项：gui.o: gui.h $(COMPILE.c) -DUSE_NEW_MALLOC=1 $(OUTPUT_OPTION) $<当规则有改动，或者有许多这样的文件需要处理，就会做很多重复的动作。为了解决此类问题，make提供了工作目标的专属变量。这些变量的定义会附加在工作目标之上，且只有该工作目标以及相应的任何必要条件被处理的时候，它们才会起作用。通过使用专属变量，可以把前面的例子改写为gui.o: CPPFLAGS += -DUSE_NEW_MALLOC=1 gui.o: gui.h $(COMPILE.c) $(OUTPUT_OPTION) $<工作目标的专属变量的语法如下所示：target...: variable = value target...: variable := value target...: variable += value target...: variable ?= value这类变量的赋值动作会延后到开始处理工作目标的时候进行。所以赋值运算符右边部分的值，可由另一个工作目标的专属变量来设定。同样地，此变量只有在必要条件的处理期间，才会发生作用。6. 变量来自何处文件在文件中创建，或者通过include指令引入命令行直接在make命令行上定义或重新定义变量：$ make CFLAGS=-g CPPFLAGS='-DBSD -DDEBUG'在命令行上，每个变量赋值运算符的右边部分必须是一个单独的shell参数。如果变量的值（或变量本身）包含空格，则必须为参数加上括号或是规避空格。命令行上变量的赋值结果将会覆盖掉环境变量以及makefile文件中的赋值结果。还可以使用:=或=赋值运算符将命令行参数设定成简单或递归变量。此外，如果使用override指令，你还可以要求make采用makefile的赋值结果，而不要采用命令行的赋值结果。环境make启动时，所有来自环境的变量都会被自动定义成make的变量。这些环境变量的优先级很低，所以makefile文件或命令行参数的赋值结果将会覆盖掉环境变量的值。不过，可以使用--environment-overrides或-e命令行选项，让环境变量覆盖掉相应的makefile变量。当make被递归调用时，有若干来自上层的make变量会通过环境传递给下层的make。默认情况下，只有原先就来自环境的变量会被导出到下层的环境之中。不过，你只要使用export指令就可以让任何变量被导出到环境之中：要求将所有变量全部导出，可以这么做：export请注意，即使这些变量的名称包含了无效的shell变量字符，make也会进行导出的动作。使用unexport可以避免环境变量被导出到子进程条件赋值运算符与环境变量的交互良好。假如你已经在makefile中定义了输出目录，但是你希望用户能轻易地改写，使用条件赋值运算符将会是最佳解决方案：# 假设输出目录为$(PROJECT_DIR)/out OUTPUT_DIR ?= $(PROJECT_DIR)/out使用下面的较冗长的方式同样可以实现同样的效果ifndef OUTPUT_DIR # 假设输出目录为$(PROJECT_DIR)/out OUTPUT_DIR = $(PROJECT_DIR)/out endif其中的差别在于，如果变量的值已经设定，那么即使是空值，条件赋值运算符也会跳过赋值的动作，而运算符ifdef和ifndef只会测试“非空值”。因此，我们会使用条件运算符而不会使用ifdef来对OUTPUT_DIR赋值。不建议过多的使用环境变量自动创建最后，make会在执行一个规则的命令脚本之前立刻创建自动变量。7. 条件指令条件指令的基本语法如下所示：if-condition text if the condition is true endif或：if-condition text if the condition is true else text if the condition is false endif其中，if-condition可以是以下之一:ifdef variable-name ifndef variable-name ifeq test ifneq test进行ifdef/ifndef的测试时，不应该以$()括住variable-name。最后，test可以表示成下面这样 "a" "b" 或 （a,b）其中，单引号或双引号可以交替使用（但是引号必须成对出现）。条件处理指令可用在宏定义和命令脚本中，还可以放在makefile的顶层：libGui.a: $(gui_objects) $(AR) $(ARFLAGS) $@ $< ifdef RANLIB $ (RANLIB) $@ endif我喜欢缩排我的条件指令，但是草率的缩排动作可能会导致错误。在前面的例子中，条件指令被缩排了四个空格，而且其所括住的命令具有一个前导的tab符号。如果其所括住的命令并非以一个tab符开头，make将不会把它视为命令；如果条件指令具有一个前导的tab符，make会误以为"条件指令"就是"命令"而将之传递给subshell。ifeq和ifneq条件指令可用来测试其参数是否相等。条件指令里空格的处理有些微妙。举例来说，如果参数采用小括号的形式，那么逗号之后的空格将会被忽略，除此之外所有其他的空格都是有意义的：ifeq (a, a) # These are equal endif ifeq ( b, b ) # So are these endif我比较喜欢使用等效的引号形式：ifeq "a" "a" # These are equal endif ifeq 'b' 'b' # So are these endif即使如此，还是经常会发生"变量扩展后包含了非预期的空格符号"的状况。这可能引发一些问题，因为进行匹配时会将所有字符纳入考虑。为了创建更稳定的makefile，我们会使用strip函数。ifeq "$(strip $(OPTIONS))" "d" COMPILATION_FLAGS += -DDEBUG endif8. include指令用法include xxx.mk引入文件与依存关系当make看到include指令时，会事先对通配符以及变量引用进行扩展的动作，然后试着读进include的文件。如果这个文件存在，则整个处理过程会继续下去；然而，如果这个文件不存在，则make会汇报问题并且继续读取其余的makefile。当所有的读取动作皆已完成之后，make会从规则数据库中找出任何可用来更新引入文件的规则。如果找到了一个相符的规则，make就会按照正常的步骤来更新工作目标。如果任何一个引入文件被规则更新，make接着会清楚它的内部数据库并且重新读进整个makefile。如果完成读取、更新和重新读取的过程之后，仍有include指令因为文件不存在而执行失败，那么make就会显示错误状态并终止执行。如果想让make忽略无法加载的引入文件，可以为include指令前置一个破折号-include xxx.mk 9. 标准的make变量除了自动变量，make还会为“自己的状态以及内置规则的定义”提供变量，以便对外提供相关信息：MAKE_VERSIONGNU make的版本号CURDIR正在执行make进程的当前工作目录。此变量的值将会是shell变量PWD的值，除非make在运行时用到了--directory（或-C）选项。--directory选项会使得make在搜索任何makefile之前变更到不同的目录。这个选项的完整形式为--directory=directory-name或-C directory-name。这样，CURDIR将会包含--include-dir的目录参数。在makefile文件中，所有路径都应该被设定成相对于makefile所在的目录。需要使用绝对路径时可以通过CURDIR进行访问。MAKEFILE_LISTmake所读进的各个makefile文件的名称所构成的列表，包括默认的makefile以及命令行或include指令所指定的makefile。在每个makefile被读进make之前，其文件名会被附加到MAKEFILE_LIST变量里。所以，任何一个总是可以查看此列表的最后一项来判断自己的文件名。MAKECMDGOALS对当前运行的make而言，make运行时命令行上指定了哪些工作目标。此变量并不包含命令行选项或变量的赋值。.VARIABLES到目前为止，make从各个makefile文件所读进的变量的名称所构成的列表，不含工作目标的专属变量。此变量仅供读取，对它所进行的任何赋值动作都会被忽略掉。

Make--(3)函数 1. 用户自定义函数用户自定义函数能够将命令序列存储在变量里，让我们得以在makefile中使用各种应用程序。2.内置函数make的内置函数可分类为：字符串操作、文件名操作、流程控制、用户自定义函数以及若干重要的杂项函数。所有的函数都会具有如下形式：$(function-name arg1[, argn])$(之后是内置函数的名称，接着是函数的参数。第一个参数的前导空格会被删除，但是后续的任何参数若包含前导（当然也包括内置的和结尾的）空格则都会被保留下来。函数的参数是以逗号为分隔符，所以只有一个参数的函数并不需要使用逗号。许多只接受一个函数的参数会把它的参数视为一串以空格隔开的单词。对这些函数而言，它们会以空格作为分隔符。2.1 字符串函数1. filter函数名称：过滤函数filter格式：$(filter <pattern...>,<text> )返回：返回符合模式<pattern>的字串。功能：以<pattern>模式过滤<text>字符串中的单词，保留符合模式<pattern>的单词。可以有多个模式。存在多个模式时，模式表达式之间使用空格分割。实例：sources := foo.c bar.c baz.s ugh.h foo: $(sources) cc $(filter %.c %.s,$(sources)) -o foo $(filter %.c %.s,$(sources))返回的值是“foo.c bar.c baz.s”。2. filter-out函数名称：反过滤函数filter-out格式：$(filter-out <pattern...>,<text> )返回：返回不符合模式<pattern>的字串。功能：以<pattern>模式过滤<text>字符串中的单词，去除符合模式<pattern>的单词。可以有多个模式。存在多个模式时，模式表达式之间使用空格分割。实例：objects=main1.o foo.o main2.o bar.o mains=main1.o main2.o $(filter-out $(mains),$(objects)) 返回值是“foo.o bar.o”。 3. findstring函数名称：查找字符串函数格式：$(findstring <find>,<in> )返回：如果找到，那么返回<find>，否则返回空字符串。功能：在字串<in>中查找<find>字串。实例：str1 := a b c str2 := b c 第一个函数返回“a”字符串，第二个返回空字符串 all: @echo $(findstring a,$(str1)) @echo $(findstring a,$(str2))4. subst函数名称：字符串替换函数格式：$(subst <search-string>, <replace-string>, <text>)返回：函数返回被替换过后的字符串。功能：把字串<text>中的<from>字符串替换成<to>，不具备通配符能力，它最常被用来在文件名列表中将一个扩展名替换成另一个扩展名。实例：$(subst a,the,There is a big tree) 把“There is a big tree”中的“a”替换成“the”，返回结果是“There is the big tree”。5. patsubst函数名称：模式字符串替换函数格式：$(patsubst <search-pattern>,<replace-pattern>,<text> )返回：函数返回被替换过后的字符串,具备通配符能力。此处的模式只可以包含一个%字符。功能：查找<text>中的单词（单词以“空格”、“Tab”或“回车”“换行”分隔）是否符合模式<search-pattern>，如果匹配的话，则以<replace-pattern>替换。这里，<search-pattern>可以包括通配符“%”，表示任意长度的字串。如果<replace-pattern>中也包含“%”，那么，<replace-pattern>中的这个“%”将是<search-pattern>中的那个“%”所代表的字串。（可以用“”来转义，以“%”来表示真实含义的“%”字符）实例：$(patsubst %.c,%.o,x.c.c bar.c) 把字串“x.c.c bar.c”符合模式[%.c]的单词替换成[%.o]，返回结果是“x.c.o bar.o”6. words函数名称：返回单词数量格式：$(words text)返回：text中的单词数量功能：返回text中单词数量。其中，$(word n,text)返回text中的第n个单词，第一个单词的编号是1.如果n的值大于text中单词的个数，则此函数将返回空值实例：current := $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST))通过这种方式可以获得列表中的最后一个单词，在这里将返回最近读取的makefile的文件名。7. firstword函数名称：格式：$(firstword text)返回：功能：此函数返回text中的第一个单词。此功能等效于$(word 1,text)实例：8. wordlist函数名称：格式：$(wordlist start,end,text)返回：返回text中范围从start(含)到end(含)的单词。如果start的值大于单词的个数，返回空值。如果end的值大于单词的个数，则函数返回从start开始的所有单词。功能：实例：2.2 重要的杂项函数1. sort函数名称：sort函数格式：$(sort list)返回：返回按照字典编纂顺序排列的不重复的单词列表，并以空格作为分隔符。功能：sort函数会排序它的list参数并移除重复的项目。此外，sort函数还会删除前导以及结尾的空格。实例：2. shell函数名称：shell函数格式：$(shell <fun>)返回：shell函数的返回值。输出中所出现的一系列换行符号会被缩减成单一空格符号，任何接在后面的换行符号都会被删除。标准错误以及任何程序的结束状态都不会被返回。功能：为了使用shell的函数实例：例如files := $(shell echo *.c)2.3 文件名函数makefile的编写者通常会花许多时间在文件的处理上。1. wildcard函数名称：通配符展开函数格式：$(wildcard PATTERN...)返回：如果被扩展的模式找不到相符的文件，则会返回空字符串。功能：在Makefile规则中，通配符会被自动展开。但在变量的定义和函数引用时，通配符将失效。这种情况下如果需要通配符有效，就需要使用函数“wildcard”实例：一般我们可以使用“$(wildcard *.c)”来获取工作目录下的所有的.c文件列表。复杂一些用法；可以使用“$(patsubst %.c,%.o,$(wildcard *.c))”，首先使用“wildcard”函数获取工作目录下的.c文件列表；之后将列表中所有文件名的后缀.c替换为.o。这样我们就可以得到在当前目录可生成的.o文件列表。2. dir函数名称：格式：$(dir list...)返回：功能：dir函数返回list中每个单词的目录部分。实例：3. notdir函数名称：格式：$(notdir name...)返回：功能：notdir函数返回文件路径的文件名部分。实例：4. suffix函数名称：格式：$(suffix name...)返回：功能：suffix函数会返回它的参数中每个单词的后缀（即文件扩展名）实例：5. basename函数名称：格式：$(basename name...)返回：功能：实例：6. addsuffix函数名称：格式：返回：功能：实例：7. addprefix函数名称：格式：返回：功能：实例：8. join函数名称：格式：返回：功能：实例：2.4 流程控制4. foreach函数名称：循环替换函数格式：$(foreach <var>,<list>,<text> )返回：返回循环<text>语句最终执行的结果功能：把参数<list>中的单词逐一取出放到参数<var>所指定的变量中， 然后再执行<text>所包含的表达式。每一次<text>会返回一个字符串，循环这个过程。实例：letters ：= $(foreach letter, a b c d, $(letter)) show-words: # letters has $(words $(letters)) words: `$(letters)` $ make # letters has 4 words: 'a b c d'当这个foreach函数被执行时，它会反复扩展循环主体$(letter)，并且将循环控制变量letter的值依次设定成a、b、c、d。每次扩展所得到的文本会被累积起来，并以空格为分隔符。2.5 较不重要的杂项函数7. strip函数名称：去空字符函数格式：$(strip <string> )返回：返回被去掉空格的字符串值。功能：去掉<string>字串中开头和结尾的空字符,并将中间的多个连续空字符(如果有的话)合并为一个空字符实例：str1 := abc str2 := abc str3 := a b c all: @echo $(strip $(str1)) @echo $(strip $(str2)) @echo $(strip $(str3)) 输出结果： abc abc a b c 10. call函数名称：call函数是唯一一个可以创建定制化参数函数的引用函数。支持对自定义函数的引用;格式：$(call VARIABLE,PARAM,PARAM,...)返回：VARIABLE展开后的表达式的值功能：在执行时,将它的参数"PARAM"依次赋给临时变量"(1)","(2)".call对参数的数目没有限制，也可以没有参数值。最后再对VARIABLE展开后的表达式进行处理.说明：变量VARIABLE在定义时最好定义为递归展开式;call函数中对VARIABLE的调用,直接给函数或变量名就好了，不要用"$";多个PARAM使用逗号分割开,且逗号和PARAM之间不能有空格，否则会导致解析异常;实例：(1)变量的引用变量定义为直接展开式如果这里将VARIABLE1定义为直接展开式,最终调用call函数后，返回值为空我的理解是,直接展开式在定义时将(1)和(2)展开,而此时它们的值为空,所以变量的值为空.当执行到call函数时，尽管带上了需要传递的参数,但PARAM((1)和(2))之前已经被展开了,故此时已经取不到传递进来的参数值.VARIABLE1 ：= $(2) $(1) $(info 1-$(VARIABLE1)) aa=$(call VARIABLE1,hello,world) $(info 1-$(aa)) all： @echo Done定义为递归展开式VARIABLE1 = $(2) $(1) $(info 2-$(VARIABLE1)) aa=$(call VARIABLE1,hello,world) $(info 2-$(aa)) all： @echo Done(2)函数的引用不带参数的函数引用define FUNC1 $(info echo 3-"hello") endef $(call FUNC1) all: @echo Done 带参数的函数引用define FUNC1 $(info echo 4-$(1) $(2)) endef $(call FUNC1,hello,wolrd) all: @echo Done 1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：1. patsubst函数名称：格式：返回：功能：实例：

Make--(1)规则 makefile中的工作目标依存于一组必要条件，这些条件一般也都是文件。当你要求更新某个工作目标时，如果必要条件中存在时间戳在工作目标的时间戳之后的文件，make就会执行相应规则里的命令脚本。因为某个规则的工作目标可以是另一个规则的必要条件，所以这样的工作目标和必要条件将会形成依存图（dependency graph）。建立及处理依存图，并据此更新特定的工作目标，就是make所要做的事。规则对make而言十分重要，make允许你使用各种类型的规则。