Makefile的条件执行

1 前言

条件语句可以根据一个变量的值来控制make执行或者忽略Makefile 的特定部分。条件语句可以是两个不同变量、或者变量和常量值的比较

注意：条件语句只能用于控制make实际执行的makefile文件部分，它不能控制规则的shell命令执行过程

2 基本语法

1. 一个简单的不包含“else”分支的条件判断语句的语法格式为

CONDITIONAL-DIRECTIVE
TEXT-IF-TRUE
endif

表达式中“TEXT-IF-TRUE”可以是若干任何文本行，当条件为真时它就将被make作为需要执行的一部分。当条件为假时，不作为需要执行的一部分

1. 包含“else”的语法格式

CONDITIONAL-DIRECTIVE
TEXT-IF-TRUE
else
TEXT-IF-FALSE
endif

如果条件为真，则将“TEXT-IF-TRUE”作为执行Makefile的一部分，否则将 “TEXT-IF-FALSE”作为执行的Makefile的一部分。和“TEXT-IF-TRUE”一样，“TEXT-IF-FALSE”可以是若干任何文本行

条件判断语句中“CONDITIONAL-DIRECTIVE”对于上边的两种格式都是同样的

2.1 例子

......
foo: $(objects)
ifeq ($(CC),gcc)
    $(CC) -o foo $(objects) $(libs_for_gcc) 
else
    $(CC) -o foo $(objects) $(normal_libs) 
endif
......

“ifeq”表示条件语句的开始，并指定了一个比较条件(相等)。之后是用圆括号括包围的、使用逗号“,”分割的两个参数，和关键字“ifeq”用空格分开。参数中的变量引用在进行变量值比较时被展开。“ifeq”之后就是当条件满足make 需要执行的，条件不满足时忽略。
“else”之后就是当条件不满足时的执行部分。不是所有的条件语句都需要此部分。
“endif”表示一个条件语句的结束，任何一个条件表达式都必须以“endif”结束

注：条件的解析是由make来完成的。make是在读取并解析Makefile时根据条件表达式忽略条件表达式中的某一个文本行，解析完成后保留的只有表达式满足条件所需要执行的文本行

3 关键字

3.1 “ifeq”

用来判断参数是否相等，格式如下

ifeq (ARG1, ARG2)
ifeq 'ARG1' 'ARG2'
ifeq "ARG1" "ARG2"
ifeq "ARG1" 'ARG2'
ifeq 'ARG1' "ARG2"

展开“ARG1”和“ARG1”后对它们的值进行比较

如果相同则(条件为真)将“TEXT-IF-TRUE”作为make要执行的一部分
否则将“TEXT-IF-FALSE”作为make要执行的一部分(上边的第二种格式)

通常我们会使用它来判断一个变量的值是否为空

因为它的参数值可能是通过引用变量或者函数得到的，因而在展开过程中可能造成参数值中包含空字符，这时用make的“strip”函数处理

ifeq ($(strip $(foo)),)
TEXT-IF-EMPTY
endif

这样就可以去掉首位空格

3.2 “ifneq”

用来判断参数是否不相等，格式如下

ifneq (ARG1, ARG2)
ifneq 'ARG1' 'ARG2'
ifneq "ARG1" "ARG2"
ifneq "ARG1" 'ARG2'
ifneq 'ARG1' "ARG2"

展开“ARG1”和“ARG1”对它们的值进行比较

如果不相同(条件为真)则将“TEXT-IF-TRUE”作为make要执行的一部分
否则将“TEXT-IF-FALSE”作为make要执行的一部分

3.3 “ifdef”

判断一个变量是否已经定义。格式如下

ifdef VARIABLE-NAME

如果变量“VAEIABLE_NAME”的值非空，那么表达式为真，将“TEXT-IF-TRUE”作为make要执行的一部分。
表达式为假，如果存在“TEXT-IF-FALSE”，就将它作为make要执行一部分。当一个变量没有被定义时，它的值为空。“VARIABLE-NAME”可以是变量或者函数的引用

注1：在 Makefile 中没有定义的变量的值为空

注2：ifdef只是测试一个变量是否有值，不会对变量进行替换展开来判断变量的值是否为空。对于变量“VARIABLE-NAME”，除了 “VARIABLE-NAME=”这种情况以外，使用其它方式对它的定义都会使“ifdef”返回真。就是说，即使我们通过其它方式(比如，定义它的值引用了其它的变量)给它赋了一个空值，“ifdef”也会返回真

例如

bar =
foo = $(bar)
ifdef foo
frobozz = yes
else
frobozz = no
endif

这个ifdef返回的是true

3.4 “ifndef”

判断一个变量是否已经定义。格式如下

ifdef VARIABLE-NAME

它的功能就是实现了和“ifdef”相反的条件判断

3.5 说明

在“CONDITIONAL-DIRECTIVE”这一行上，可以以若干个空格开始，make处理时会被忽略这些空格
不能以[Tab]字符做为开始(不然就被认为是命令)
条件判断语句中，在除关键字(包括“endif”)之前、条件表达式参数中之外的其他任何地方都可以使用多个空格或[Tab]字符，它不会影响条件判断语句的功能。同样行尾也可以使用注释(“#”开始直到一行的结束)
“else”和“endif”也是条件判断语句的一部分。在书写时它们都是没有任何参数的，可以以多个空格开始(同样不能以[Tab]字符开始)多个空格或[Tab]字符结束。行尾同样可以有注释内容。

注：在make读取makefile文件时计算表达式的值，并根据表达式的值决定判断语句中那一部分被作为此Makefile所要执行的内容(选择符合条件的语句) 因此在条件表达式中不能使用自动化变量，自动化变量在规则命令执行时才有效更不能将一个完整的条件判断语句分写在两个不同的makefile文件中，在一个makefile文件使用指示符“include”包含另外一个makefile文件

4 标记测试的条件语句

我们可以使用条件判断语句、变量“MAKEFLAGS”和函数“findstring”，实现对make命令行选项的测试（变量“MAKEFLAGS”之前的文章-7.3变量和递归有说明，函数“findstring”以后再说）
例如

archive.a: ...
ifneq (,$(findstring t,$(MAKEFLAGS)))
    +touch archive.a
    +ranlib -t archive.a
else
    ranlib archive.a
endif

语句是判断make的命令行参数中是否包含“-t”(用来更新目标文件的时间戳)。根据命令行参数情况完成对“archive.a”执行不同的操作。命令行前的“+”的意思是告诉make，即使make使用了“-t”参数，“+”之后的命令都需要被执行

Makefile学习笔记——6.Makefile的条件执行