上层 Makefile 控制下层 Makefile 的方法

在复杂的项目中，通常会将项目划分为多个模块或子项目，每个模块都有自己的 Makefile。上层 Makefile 的作用是协调和控制这些下层 Makefile 的构建过程。下面是几种常见的示例，实现上层 Makefile 对下层 Makefile 的控制。

1. 直接调用：通过 $(MAKE) 或 make 命令直接调用下层 Makefile。

2. 传递变量：通过环境变量或命令行参数将变量传递给下层 Makefile。

3. 递归构建：通过递归调用 make 命令构建所有模块。

4. 导入规则：通过 include 指令导入下层 Makefile 的规则和变量。

---

目录

一个实际例子

1.工程目录结构

2.主目录Makefile内容

3.Service目录的Makefile

4.Client目录的Makefile 

方法 1：直接调用下层 Makefile

示例项目结构

上层 Makefile 示例

下层 Makefile 示例（module1/Makefile）

使用说明

方法 2：传递变量给下层 Makefile

上层 Makefile 示例

下层 Makefile 示例（module1/Makefile）

使用说明

方法 3：使用递归构建

上层 Makefile 示例

下层 Makefile 示例（module1/Makefile）

使用说明

方法 4：使用 include 导入下层 Makefile

上层 Makefile 示例

下层 Makefile 示例（module1/Makefile）

使用说明

总结

---

一个实际例子

1.工程目录结构

├── ChatRoom
│   ├── Client
│   │   ├── Client.c
│   │   ├── Makefile
│   │   ├── Tcp_Sock.c
│   │   ├── Tcp_Sock.h
│   │   ├── main
│   │   └── obj
│   └── Service
│       ├── Makefile
│       ├── Service.c
│       ├── Tcp_Sock.c
│       ├── Tcp_Sock.h
│       ├── main
│       └── obj
├── Makefile

2.主目录Makefile内容

简单版本：

SUBDIR1 = ChatRoom/Service
SUBDIR2 = ChatRoom/Client
SUBDIRS = $(SUBDIR1) $(SUBDIR2).PHONY: all clean $(SUBDIRS)all: $(SUBDIRS)$(SUBDIRS):$(MAKE) -C $@clean:for dir in $(SUBDIRS); \do \$(MAKE) -C $$dir clean; \done

# 定义模块路径
##################################
########用户配置区#################
MODULE1 = ChatRoom/Client
MODULE2 = ChatRoom/ServiceMODULE1_TARGET = $(MODULE1)/main
MODULE2_TARGET = $(MODULE2)/mainMODULES = $(MODULE1) $(MODULE2)
MODULES_TARGET = $(MODULE1_TARGET) $(MODULE2_TARGET)
##################################
# 默认目标
all: $(MODULES_TARGET)# 构建模块
$(MODULE1_TARGET): $(MODULE1)@echo "正在编译模块：$(MODULE1)"$(MAKE) -C $(MODULE1) all$(MODULE2_TARGET): $(MODULE2)@echo "正在编译模块：$(MODULE2)"$(MAKE) -C $(MODULE2) all# 清理所有模块
clean:$(MAKE) -C $(MODULE1) clean$(MAKE) -C $(MODULE2) cleanrm -f $(MODULE1_TARGET) $(MODULE2_TARGET)# 帮助信息
help:@echo "可用命令:"@echo "  make          编译所有模块"@echo "  make clean    清理所有模块"@echo "  make help     查看帮助信息"

3.Service目录的Makefile

CC = gcc
SCRC = $(wildcard *.c)
OBJS_DIR = ./obj
OBJ = $(SCRC:%.c=$(OBJS_DIR)/%.o)
CFLAGS = -Wall -O2
LDFLAGS = -lpthread
TARGET = main# 默认目标
all: $(TARGET)$(TARGET):$(OBJ)$(CC) $^ -o $@ $(LDFLAGS)
$(OBJS_DIR)/%o:%c@mkdir -p $(OBJS_DIR)$(CC) $< -o $@	$(CFLAGS) -c echo:@echo $(OBJ)clean:rm -rf ./obj.PHONY:clean
.PHONY:echo

4.Client目录的Makefile 

CC = gcc
SCRC = $(wildcard *.c)
OBJS_DIR = ./obj
OBJ = $(SCRC:%.c=$(OBJS_DIR)/%.o)
CFLAGS = -Wall -O2
LDFLAGS = -lpthread
TARGET = main# 默认目标
all: $(TARGET)$(TARGET):$(OBJ)$(CC) $^ -o $@ $(LDFLAGS)
$(OBJS_DIR)/%o:%c@mkdir -p $(OBJS_DIR)$(CC) $< -o $@	$(CFLAGS) -c echo:@echo $(OBJ)clean:rm -rf ./obj.PHONY:clean
.PHONY:echo

方法 1：直接调用下层 Makefile

上层 Makefile 可以通过 $(MAKE) 或 make 命令直接调用下层 Makefile。这种方法简单且灵活。

示例项目结构

project/
├── Makefile         # 上层 Makefile
├── module1/
│   ├── Makefile     # 下层 Makefile
│   └── *.c
├── module2/
│   ├── Makefile     # 下层 Makefile
│   └── *.c
└── main.c

上层 Makefile 示例

# 定义下层模块的路径
MODULE1 = module1
MODULE2 = module2# 定义所有模块
MODULES = $(MODULE1) $(MODULE2)# 默认目标
all: $(MODULES)# 构建模块
$(MODULES):$(MAKE) -C $@# 清理所有模块
clean:$(MAKE) -C $(MODULE1) clean$(MAKE) -C $(MODULE2) cleanrm -f main# 帮助信息
help:@echo "可用命令:"@echo "  make          编译所有模块"@echo "  make clean    清理所有模块"@echo "  make help     查看帮助信息"

下层 Makefile 示例（module1/Makefile）

# 定义编译器
CC = gcc# 定义目标文件
TARGET = module1.o# 定义源文件
SRC = module1.c# 编译选项
CFLAGS = -g -Wall# 默认目标
all: $(TARGET)# 生成目标文件
$(TARGET):$(CC) $(CFLAGS) -c $(SRC) -o $(TARGET)# 清理
clean:rm -f $(TARGET)

使用说明

1. 编译所有模块

                上层 Makefile 会依次调用 module1/Makefile 和 module2/Makefile 进行编译。

make

1. 清理所有模块

   make clean

   上层 Makefile 会调用每个模块的 clean 目标，并清理上层生成的文件。

2. 查看帮助

   make help

---

方法 2：传递变量给下层 Makefile

上层 Makefile 可以通过环境变量或命令行参数将变量传递给下层 Makefile。

上层 Makefile 示例

# 定义构建类型
BUILD_TYPE ?= Debug# 定义下层模块的路径
MODULE1 = module1
MODULE2 = module2# 定义所有模块
MODULES = $(MODULE1) $(MODULE2)# 默认目标
all: $(MODULES)# 构建模块
$(MODULES):$(MAKE) -C $@ BUILD_TYPE=$(BUILD_TYPE)# 清理所有模块
clean:$(MAKE) -C $(MODULE1) clean$(MAKE) -C $(MODULE2) cleanrm -f main# 帮助信息
help:@echo "可用命令:"@echo "  make          编译所有模块"@echo "  make clean    清理所有模块"@echo "  make help     查看帮助信息"

下层 Makefile 示例（module1/Makefile）

# 定义编译器
CC = gcc# 定义目标文件
TARGET = module1.o# 定义源文件
SRC = module1.c# 从环境变量中获取构建类型
ifeq ($(BUILD_TYPE), Debug)CFLAGS = -g -Wall
elseCFLAGS = -O2
endif# 默认目标
all: $(TARGET)# 生成目标文件
$(TARGET):$(CC) $(CFLAGS) -c $(SRC) -o $(TARGET)# 清理
clean:rm -f $(TARGET)

使用说明

1. 编译所有模块（Debug 模式）

make

1. 编译所有模块（Release 模式）

make BUILD_TYPE=Release

1. 清理所有模块

make clean

---

方法 3：使用递归构建

上层 Makefile 可以通过递归调用 make 命令来构建所有下层模块。

上层 Makefile 示例

# 定义模块路径
MODULES = module1 module2# 默认目标
all: $(MODULES)# 构建模块
$(MODULES):@echo "构建模块: $@"$(MAKE) -C $@# 清理
clean:@echo "清理模块..."$(MAKE) -C module1 clean$(MAKE) -C module2 cleanrm -f main# 帮助信息
help:@echo "可用命令:"@echo "  make          编译所有模块"@echo "  make clean    清理所有模块"@echo "  make help     查看帮助信息"

下层 Makefile 示例（module1/Makefile）

# 定义编译器
CC = gcc# 定义目标文件
TARGET = module1.o# 定义源文件
SRC = module1.c# 编译选项
CFLAGS = -g -Wall# 默认目标
all: $(TARGET)# 生成目标文件
$(TARGET):$(CC) $(CFLAGS) -c $(SRC) -o $(TARGET)# 清理
clean:rm -f $(TARGET)

使用说明

1. 编译所有模块

make

1. 清理所有模块

make clean

---

方法 4：使用 include 导入下层 Makefile

上层 Makefile 可以通过 include 指令导入下层 Makefile 的规则和变量。

上层 Makefile 示例

# 定义模块路径
MODULES = module1 module2# 导入下层 Makefile 的变量和规则
include $(MODULES:%=%.mk)# 默认目标
all: $(MODULES:%=build_%)# 构建模块
build_%:$(MAKE) -C $* all# 清理
clean:$(MAKE) -C module1 clean$(MAKE) -C module2 cleanrm -f main# 帮助信息
help:@echo "可用命令:"@echo "  make          编译所有模块"@echo "  make clean    清理所有模块"@echo "  make help     查看帮助信息"

下层 Makefile 示例（module1/Makefile）

# 定义编译器
CC = gcc# 定义目标文件
TARGET = module1.o# 定义源文件
SRC = module1.c# 编译选项
CFLAGS = -g -Wall# 默认目标
all: $(TARGET)# 生成目标文件
$(TARGET):$(CC) $(CFLAGS) -c $(SRC) -o $(TARGET)# 清理
clean:rm -f $(TARGET)

使用说明

1. 编译所有模块

make

1. 清理所有模块

make clean

---

总结

通过上述方法，上层 Makefile 可以灵活地控制下层 Makefile 的构建过程。以下是关键点的总结：

1. 直接调用：通过 $(MAKE) 或 make 命令直接调用下层 Makefile。
2. 传递变量：通过环境变量或命令行参数将变量传递给下层 Makefile。
3. 递归构建：通过递归调用 make 命令构建所有模块。
4. 导入规则：通过 include 指令导入下层 Makefile 的规则和变量。