Краткий справочник

Шпаргалка по Makefile

Подробный справочник по GNU Make: виды присваивания переменных, автоматические переменные, префиксы команд, подстановки и условия.

· Опубликовано

GNU Make — это инструмент автоматизации сборки, создающий исполняемые файлы и библиотеки из исходного кода на основе файлов Makefile.

Присваивание переменных

foo  = "bar"       # Lazy (dynamically expanded when used)
bar  = $(foo) foo  # Dynamically references $(foo)
foo := "boo"       # Immediate (simply expanded once at declaration)
foo ?= /usr/local  # Conditional (assign only if foo is not already set)
bar += world       # Append to existing value
foo != echo hello  # Shell execution (GNU Make 4.0+)

Автоматические переменные

При выполнении команд рецепта Make предоставляет автоматические переменные для ссылок на цель и зависимости:

out.o: src.c src.h
	$@   # "out.o" (the target name)
	$<   # "src.c" (first prerequisite)
	$^   # "src.c src.h" (all prerequisites with duplicates omitted)
	$+   # "src.c src.h" (all prerequisites preserving duplicates)
	$?   # Prerequisites newer than the target
	$|   # Order-only prerequisites

%.o: %.c
	$*   # The matched pattern stem ("foo" in "foo.c")
	$(@D) # Directory part of the target ("build" in "build/out.o")
	$(@F) # File part of the target ("out.o" in "build/out.o")

Префиксы команд рецепта

Префикс Поведение
@ Не выводить команду в stdout перед выполнением
- Игнорировать ненулевые коды возврата (продолжать при ошибке)
+ Выполнять команду даже при запуске Make с флагом -n (холостой прогон)
build:
	@echo "Compiling binary..."
	-rm -rf temp/
	gcc -o main main.c

Функции и сопоставление файлов

Шаблоны и вызов оболочки

js_files  := $(wildcard src/*.js)
all_files := $(shell find images/ -type f)

Замена подстрок и фильтрация

# Extension substitution
objects = $(sources:.cpp=.o)

# Pattern substitution
outputs = $(patsubst src/%.c, build/%.o, $(wildcard src/*.c))

# Filter and filter-out
c_files = $(filter %.c, $(files))
non_c   = $(filter-out %.c, $(files))

# Whitespace stripping
clean_var = $(strip $(dirty_var))

Условные конструкции

ifeq ($(CC),gcc)
  CFLAGS += -Wall -O2
else ifeq ($(CC),clang)
  CFLAGS += -Weverything
else
  CFLAGS += -O0
endif

Флаги командной строки

make -j 8              # Run parallel jobs (8 concurrent threads)
make -B, --always-make # Unconditionally build all targets
make -n, --dry-run     # Print commands without executing
make -s, --silent      # Do not print recipe commands
make -e                # Environment variables override Makefile variables

Ссылки

Связанные темы