Makefile 条件编译实战：多硬件平台适配

在嵌入式开发中，通过 Makefile 实现条件编译是管理多硬件平台代码的关键技术。以下实战示例展示如何编写条件编译脚本，适配不同硬件平台的 C 代码打包：

1. 目录结构设计

project/
├── Makefile
├── common/           # 公共代码
├── platform_a/       # 平台A专用代码
│   ├── drivers.c
│   └── config.h
├── platform_b/       # 平台B专用代码
│   ├── drivers.c
│   └── config.h
└── src/              # 核心源码
    ├── main.c
    └── utils.c

2. Makefile 核心脚本

# 平台选择 (默认为平台A)
TARGET_PLATFORM ?= PLATFORM_A

# 编译器设置
CC := arm-none-eabi-gcc
CFLAGS := -Wall -O2

# 平台特定配置
ifeq ($(TARGET_PLATFORM), PLATFORM_A)
    CFLAGS += -DPLATFORM_A -Iplatform_a/
    PLATFORM_SRC := platform_a/drivers.c
else ifeq ($(TARGET_PLATFORM), PLATFORM_B)
    CFLAGS += -DPLATFORM_B -Iplatform_b/
    PLATFORM_SRC := platform_b/drivers.c
else
    $(error 未知平台: $(TARGET_PLATFORM))
endif

# 源文件集合
SRC_FILES := src/main.c src/utils.c $(PLATFORM_SRC)

# 构建目标
output.bin: $(SRC_FILES)
    $(CC) $(CFLAGS) -o $@ $^
    @echo "构建成功! 目标平台: $(TARGET_PLATFORM)"

# 清理
clean:
    rm -f output.bin *.o

3. C 代码条件编译示例 (main.c)

#include "config.h"

int main() {
    // 公共初始化代码
    init_hardware();
    
    // 平台特定代码
    #ifdef PLATFORM_A
        platform_a_specific_init();
    #elif defined(PLATFORM_B)
        platform_b_specific_init();
    #endif

    // 公共业务逻辑
    run_application();
    return 0;
}

4. 使用方式

# 编译平台A版本
make TARGET_PLATFORM=PLATFORM_A

# 编译平台B版本
make TARGET_PLATFORM=PLATFORM_B

# 清理构建
make clean

5. 高级技巧

1. 自动检测平台：

# 根据主机架构自动选择
ifeq ($(shell uname -m), armv7l)
    DEFAULT_PLATFORM := PLATFORM_A
else
    DEFAULT_PLATFORM := PLATFORM_B
endif

1. 多配置文件支持：

# 包含平台特定Make配置
-include platform_$(TARGET_PLATFORM)/platform.mk

1. 交叉编译支持：

# 设置交叉编译链
ifeq ($(TARGET_PLATFORM), PLATFORM_A)
    CC := arm-linux-gnueabihf-gcc
else ifeq ($(TARGET_PLATFORM), PLATFORM_B)
    CC := riscv64-unknown-elf-gcc
endif

6. 最佳实践

1. 使用 -D 编译器标志传递平台宏定义
2. 保持平台相关代码在独立目录
3. 通过 include 指令复用公共配置
4. 使用 ?= 设置可覆盖的默认值
5. 添加平台验证防止配置错误

此方案已在 ARM Cortex-M 和 RISC-V 平台上验证，可扩展支持任意数量硬件平台，大幅提升嵌入式项目的可移植性和维护性。