【转】Makefile中的$(error)和$(warning)

最新推荐文章于 2024-11-27 11:28:41 发布

转载最新推荐文章于 2024-11-27 11:28:41 发布 · 2.4w 阅读

文章标签：

#makefile #gnu

Makefile 专栏收录该内容

8 篇文章

订阅专栏

本文介绍了Makefile中$(error)和$(warning)函数的使用方法。$(error)用于生成致命错误并退出make进程，而$(warning)则仅提示信息但不中断编译流程。文章通过示例详细阐述了这两种函数的特性及其应用。

摘自《GNU+Makefile中文手册》整理翻译：徐海兵

Makefile中的$(error)和$(warning)

make 提供了两个控制 make 运行方式的函数。通常它们用在 Makefile 中，当 make执行过程中检测到某些错误是为用户提供消息，并且可以控制 make 过程是否继续。

$(error TEXT…)

函数功能：产生致命错误，并提示“ TEXT…”信息给用户，并退出 make 的执行。

需要说明的是：
“error”函数是在函数展开式（函数被调用时）才提示信息并结束 make进程。
因此如果函数出现在命令中或者一个递归的变量定义中时，在读取 Makefile 时不会出现错误。
而只有包含“error”函数引用的命令被执行，或者定义中引用此函数的递归变量被展开时，才会提示致命信息“TEXT…”同时退出 make。

返回值：空

函数说明：“error”函数一般不出现在直接展开式的变量定义中，否则在make读取Makefile时将会提示致命错误。关于递归展开和直接展开可参考 5.2 两种变量定义一节

假设我们的 Makefile 中包含以下两个片断；
示例 1：

ifdef ERROR1
$(error error is $(ERROR1))
endif

make读取解析Makefile时，如果只起那已经定义变量“ EROOR1”， make将会提示致命错误信息“ $(ERROR1)”并退出。关于“ ifdef”可参考 7.2.1.3 关键字“ ifdef” 一小节。
示例 2：

ERR = $(error found an error!)
.PHONY: err
err: ; $(ERR)

这个例子，在 make 读取 Makefile 时不会出现致命错误。只有目标“ err”被作为一个目标被执行时才会出现。

$(warning TEXT…)

函数功能：函数“ warning”类似于函数“ error”，区别在于它不会导致致命错误（ make 不退出），而只是提示“ TEXT…”， make 的执行过程继续。

返回值：空

函数说明：用法和“ error”类似，展开过程相同。