TL; DR : Використовуйте error
функцію :
ifndef MY_FLAG
$(error MY_FLAG is not set)
endif
Зверніть увагу, що рядки не повинні бути відступними. Точніше, жодні вкладки не повинні передувати цим рядкам.
Загальне рішення
Якщо ви збираєтеся перевірити багато змінних, для цього варто визначити допоміжну функцію:
# Check that given variables are set and all have non-empty values,
# die with an error otherwise.
#
# Params:
# 1. Variable name(s) to test.
# 2. (optional) Error message to print.
check_defined = \
$(strip $(foreach 1,$1, \
$(call __check_defined,$1,$(strip $(value 2)))))
__check_defined = \
$(if $(value $1),, \
$(error Undefined $1$(if $2, ($2))))
А ось як ним користуватися:
$(call check_defined, MY_FLAG)
$(call check_defined, OUT_DIR, build directory)
$(call check_defined, BIN_DIR, where to put binary artifacts)
$(call check_defined, \
LIB_INCLUDE_DIR \
LIB_SOURCE_DIR, \
library path)
Це призведе до такої помилки:
Makefile:17: *** Undefined OUT_DIR (build directory). Stop.
Примітки:
Справжня перевірка робиться тут:
$(if $(value $1),,$(error ...))
Це відображає поведінку ifndef
умовного, так що змінна, визначена порожнім значенням, також вважається "невизначеною". Але це справедливо лише для простих змінних і явно порожніх рекурсивних змінних:
# ifndef and check_defined consider these UNDEFINED:
explicitly_empty =
simple_empty := $(explicitly_empty)
# ifndef and check_defined consider it OK (defined):
recursive_empty = $(explicitly_empty)
Як запропонував @VictorSergienko у коментарях, може бути бажаною дещо інша поведінка:
$(if $(value $1)
тестує, якщо значення не порожнє. Іноді добре, якщо змінна визначена з порожнім значенням . Я б користувався$(if $(filter undefined,$(origin $1)) ...
І:
Більше того, якщо це каталог і він повинен існувати, коли перевірка виконується, я б використовував $(if $(wildcard $1))
. Але була б інша функція.
Цільова перевірка
Можна також розширити рішення так, що можна вимагати змінну, лише якщо викликається певна ціль.
$(call check_defined, ...)
зсередини рецепта
Просто перенесіть чек у рецепт:
foo :
@:$(call check_defined, BAR, baz value)
Ведучий @
знак вимикає команду, що лунає, і :
є фактичною командою, заглушкою без оболонки оболонки .
Показано назву цілі
check_defined
Функція може бути поліпшена також вихід цільового імені ( при умови , через $@
змінну):
check_defined = \
$(strip $(foreach 1,$1, \
$(call __check_defined,$1,$(strip $(value 2)))))
__check_defined = \
$(if $(value $1),, \
$(error Undefined $1$(if $2, ($2))$(if $(value @), \
required by target `$@')))
Отже, тепер невдала перевірка дає добре відформатований вихід:
Makefile:7: *** Undefined BAR (baz value) required by target `foo'. Stop.
check-defined-MY_FLAG
спеціальна ціль
Особисто я б скористався простим і зрозумілим рішенням вище. Однак, наприклад, ця відповідь пропонує використовувати спеціальну ціль для здійснення фактичної перевірки. Можна спробувати узагальнити це та визначити ціль як неявне правило шаблону:
# Check that a variable specified through the stem is defined and has
# a non-empty value, die with an error otherwise.
#
# %: The name of the variable to test.
#
check-defined-% : __check_defined_FORCE
@:$(call check_defined, $*, target-specific)
# Since pattern rules can't be listed as prerequisites of .PHONY,
# we use the old-school and hackish FORCE workaround.
# You could go without this, but otherwise a check can be missed
# in case a file named like `check-defined-...` exists in the root
# directory, e.g. left by an accidental `make -t` invocation.
.PHONY : __check_defined_FORCE
__check_defined_FORCE :
Використання:
foo :|check-defined-BAR
Зверніть увагу , що check-defined-BAR
зазначений в якості замовлення тільки ( |...
) передумови.
Плюси:
- (мабуть) більш чистий синтаксис
Мінуси:
Я вважаю, що ці обмеження можна подолати, використовуючи деякі eval
магічні та вторинні хаки розширення , хоча я не впевнений, що цього варто.