类Windows方式在Linux和macOS上静态链接SDL2库的问题

1. 调整SDL系列库的编译参数 #

无论Linux还是macOS，编译SDL2、SDL2_image、SDL2_mixer、SDL2_ttf时必须生成静态库，避免依赖系统动态库。执行configure时添加以下核心参数：

../configure \
  --prefix=/your/local/install/path \
  --enable-static \
  --disable-shared \
  --disable-sdltest

针对不同库的额外参数：

• SDL2_image：指定静态编译的图片格式依赖（如png、jpeg），确保这些依赖被静态嵌入：

  ../configure \
    --prefix=/your/path \
    --enable-static \
    --disable-shared \
    --with-png=/path/to/static/libpng \
    --with-jpeg=/path/to/static/libjpeg
  

• SDL2_mixer：指定静态版本的音频依赖（如ogg、vorbis、fmod），解决Linux下fmod未定义引用问题：

  ../configure \
    --prefix=/your/path \
    --enable-static \
    --disable-shared \
    --with-ogg=/path/to/static/libogg \
    --with-vorbis=/path/to/static/libvorbis \
    --with-fmod=/path/to/static/fmod
  

• SDL2_ttf：指定静态freetype依赖：

  ../configure \
    --prefix=/your/path \
    --enable-static \
    --disable-shared \
    --with-freetype=/path/to/static/freetype
  

编译完成后，将/your/local/install/path下的include和lib目录完整复制到项目仓库的对应平台目录（如libs/linux/x86_64、libs/macos/x86_64）。

2. 修正Makefile的链接配置 #

分平台设置编译、链接参数，确保头文件和库路径正确，链接顺序符合依赖关系：

Linux平台 #

• 头文件路径：-I./libs/linux/x86_64/include
• 库路径：-L./libs/linux/x86_64/lib
• 链接参数：按依赖逆序排列库，同时添加系统必要依赖：

  LIBS_LINUX = -lSDL2_mixer -lSDL2_image -lSDL2_ttf -lSDL2 -lm -ldl -pthread -static-libgcc -static-libstdc++
  

  注：避免直接用-static（部分系统库无法静态链接），用-static-libgcc和-static-libstdc++保证SDL相关库静态嵌入。

macOS平台 #

• 头文件路径：-I./libs/macos/x86_64/include
• 库路径：-L./libs/macos/x86_64/lib
• 链接参数：除SDL静态库外，必须添加macOS系统核心框架（无法避免，但不影响统一目录结构），解决_CFArrayAppendValue未定义引用：

  LIBS_MACOS = -lSDL2_mixer -lSDL2_image -lSDL2_ttf -lSDL2 -framework CoreFoundation -framework AudioToolbox -framework Cocoa -framework IOKit -framework CoreAudio
  

  可添加-mmacosx-version-min=10.15指定最低兼容版本。

Windows（MinGW） #

保持现有配置即可，确保使用下载的MinGW静态库。

最终Makefile示例结构：

# 检测平台
UNAME_S := $(shell uname -s)
ifeq ($(UNAME_S),Linux)
  INC_DIR = -I./libs/linux/x86_64/include/SDL2
  LIB_DIR = -L./libs/linux/x86_64/lib
  LIBS = $(LIBS_LINUX)
endif
ifeq ($(UNAME_S),Darwin)
  INC_DIR = -I./libs/macos/x86_64/include/SDL2
  LIB_DIR = -L./libs/macos/x86_64/lib
  LIBS = $(LIBS_MACOS)
endif
ifeq ($(findstring MINGW,$(UNAME_S)),MINGW)
  INC_DIR = -I./libs/win32/i686-w64-mingw32/include/SDL2
  LIB_DIR = -L./libs/win32/i686-w64-mingw32/lib
  LIBS = -lSDL2_mixer -lSDL2_image -lSDL2_ttf -lSDL2 -lmingw32 -lSDL2main -lm -ldinput8 -ldxguid -ldxerr8 -luser32 -lgdi32 -lwinmm -limm32 -lole32 -loleaut32 -lshell32 -lversion -luuid
endif

# 编译规则
game: main.c
  gcc $(INC_DIR) $(LIB_DIR) main.c -o game $(LIBS)

3. 补充依赖库到项目仓库 #

确保所有SDL依赖的第三方静态库（如libpng、libjpeg、libogg、libvorbis、fmod、freetype）都已包含在项目的libs目录中，且编译SDL系列库时已指定这些静态库的路径，避免链接时依赖系统库。

内容的提问来源于stack exchange，提问作者Bekka Mushko