Referência rápida

Folha de dicas de Makefile

Guia completo do GNU Make: tipos de atribuição de variáveis, variáveis automáticas, prefixos de comando, regras de padrão e condicionais.

· Publicado

GNU Make é uma ferramenta de automação de build que compila executáveis e bibliotecas a partir do código-fonte lendo arquivos Makefile.

Atribuições de variáveis

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+)

Variáveis automáticas

Na execução da receita, o Make expõe variáveis automáticas para referenciar o alvo e os pré-requisitos:

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")

Prefixos de comando de receita

Prefixo Comportamento
@ Não exibir o comando no stdout antes de executar
- Ignorar códigos de saída diferentes de zero (continuar no erro)
+ Executar comando mesmo se o Make rodar com -n (simulação)
build:
	@echo "Compiling binary..."
	-rm -rf temp/
	gcc -o main main.c

Funções e correspondência de arquivos

Curingas e Shell

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

Substituição de strings e filtragem

# 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))

Condicionais

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

Sinalizadores de linha de comando

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

Referências

Temas relacionados