[Make]Makefile 模版 | 易学教程

一.小型工程的 Makefile

1-何为小型工程

如果把源文件即.cpp文件放在一个文件夹下，那么该文件夹下的子文件夹不能包含任何.cpp文件
只有一个目标需要构建

2-情景描述

如果一个工程的目录/源代码组织形式符合如下描述，那么我们称其为小型工程:

根目录: 包含main文件
- bin 目录: 包含目标文件
- obj 目录: 包含所有中间文件
- src: 包含所有与编译有关的源文件
  - 注意: src 目录下的子文件夹中不应包含任何与编译有关的源文件，如有，请移动到 src 的根目录下

3-工作流程

在根目录执行 make，其生成目标文件依赖于 OBJ

OBJ 根据 SRC 来生成所有的目标文件名，而 SRC 是通过搜索 SRC_PATH 下所有符合模式 .c* 的文件而实现(.c, .cpp, .cc 等文件均会被包括)

如果 OBJ 中有任何过时/没有生成的中间文件，会首先生成对应中间文件，然后重新生成目标文件

4-模版

# tool marcros
CC := g++
CCFLAG :=
DBGFLAG := -g
CCOBJFLAG := $(CCFLAG) -c

# path marcros
BIN_PATH := bin
OBJ_PATH := obj
SRC_PATH := src
DBG_PATH := debug

# compile marcros
TARGET_NAME := main
ifeq ($(OS),Windows_NT)
    TARGET_NAME := $(addsuffix .exe,$(TARGET_NAME))
endif
TARGET := $(BIN_PATH)/$(TARGET_NAME)
TARGET_DEBUG := $(DBG_PATH)/$(TARGET_NAME)
MAIN_SRC := src/main.cpp #

# src files & obj files
SRC := $(foreach x, $(SRC_PATH), $(wildcard $(addprefix $(x)/*,.c*)))
OBJ := $(addprefix $(OBJ_PATH)/, $(addsuffix .o, $(notdir $(basename $(SRC)))))
OBJ_DEBUG := $(addprefix $(DBG_PATH)/, $(addsuffix .o, $(notdir $(basename $(SRC)))))

# clean files list
DISTCLEAN_LIST := $(OBJ) \
                  $(OBJ_DEBUG)
CLEAN_LIST := $(TARGET) \
              $(TARGET_DEBUG) \
              $(DISTCLEAN_LIST)

# default rule
default: all

# non-phony targets
$(TARGET): $(OBJ)
    $(CC) $(CCFLAG) -o $@ $?

$(OBJ_PATH)/%.o: $(SRC_PATH)/%.c*
    $(CC) $(CCOBJFLAG) -o $@ $<

$(DBG_PATH)/%.o: $(SRC_PATH)/%.c*
    $(CC) $(CCOBJFLAG) $(DBGFLAG) -o $@ $<

$(TARGET_DEBUG): $(OBJ_DEBUG)
    $(CC) $(CCFLAG) $(DBGFLAG) $? -o $@


run:
    ./bin/main

# phony rules
.PHONY: all
all: $(TARGET)

.PHONY: debug
debug: $(TARGET_DEBUG)

.PHONY: clean
clean:
    @echo CLEAN $(CLEAN_LIST)
    @rm -f $(CLEAN_LIST)

.PHONY: distclean
distclean:
    @echo CLEAN $(CLEAN_LIST)
    @rm -f $(DISTCLEAN_LIST)