如何在macOS下通过CMake自动下载SDL2依赖并构建项目

针对你在macOS下希望实现和Windows一致的SDL2依赖自动管理需求（无需全局安装，依赖存储在项目目录内，构建时自动下载解压），以下是适配后的CMake配置方案，解决dmg版本链接错误的问题：

核心修改说明 #

• 替换SDL2下载源为macOS专用的开发压缩包（dmg面向系统全局安装，不适合项目本地依赖）
• 优化FetchContent路径配置，确保依赖解压到指定的dependencies/SDL2目录
• 适配macOS下的库查找与链接逻辑，避免全局查找SDL2

完整CMakeLists.txt代码 #

cmake_minimum_required(VERSION 3.27)
project(bomberman_remake C)

set(CMAKE_C_STANDARD 23)

# 更新CMake模块路径
set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_SOURCE_DIR}/cmake")

# MSVC编译器警告配置（仅Windows生效）
if (MSVC)
    message(STATUS "Adding compile definitions for MSVC")
    add_compile_definitions(/Wall /WX)
endif ()

# 根据操作系统选择对应的SDL2下载包
if(APPLE)
    # macOS下使用SDL2的开发压缩包
    set(SDL2_DOWNLOAD_URL "https://github.com/libsdl-org/SDL/releases/download/release-2.30.1/SDL2-devel-2.30.1-macos.tar.gz")
elseif(WIN32)
    # Windows保持原配置
    set(SDL2_DOWNLOAD_URL "https://github.com/libsdl-org/SDL/releases/download/release-2.30.1/SDL2-devel-2.30.1-VC.zip")
endif()

# SDL2解压目录（项目本地的dependencies目录）
set(SDL2_EXTRACTION_DIRECTORY "${CMAKE_SOURCE_DIR}/dependencies/SDL2")

# 自动下载并解压SDL2
message(STATUS "Trying to download and extract SDL library")
include(FetchContent)
FetchContent_Declare(SDL2 
    URL ${SDL2_DOWNLOAD_URL} 
    SOURCE_DIR ${SDL2_EXTRACTION_DIRECTORY}
    OVERRIDE_FIND_PACKAGE  # 强制find_package使用本地下载的SDL2，而非全局查找
)
FetchContent_MakeAvailable(SDL2)

# 添加项目自身的头文件目录
include_directories(${CMAKE_CURRENT_SOURCE_DIR}/include)

# 查找本地下载的SDL2
find_package(SDL2 REQUIRED)

# 添加SDL2头文件目录
include_directories(${SDL2_INCLUDE_DIRECTORIES})

# 添加可执行文件源文件
message(STATUS "Locating source files for executable linking")
add_executable(bomberman_remake src/main.c
        src/debugger.c
        src/game.c
        src/scene.c
        src/event_dispatcher.c
        src/player.c
        src/node.c
        src/map.c
        src/physics.c
        src/bomb.c
        src/asset_manager.c
        src/enemy.c
)

# 链接SDL2库：macOS下SDL2的库路径通过find_package自动识别，无需手动指定
target_link_libraries(bomberman_remake PRIVATE ${SDL2_LIBRARIES})

关键细节解释 #

1. 操作系统分支处理：通过APPLE和WIN32宏区分系统，自动选择对应平台的SDL2开发包，保证跨平台兼容性
2. OVERRIDE_FIND_PACKAGE参数：强制find_package使用FetchContent下载的本地SDL2，避免CMake去系统路径查找全局安装的版本
3. macOS库链接：SDL2的macOS开发包包含了正确的动态库和头文件结构，find_package会自动识别SDL2_LIBRARIES的路径，无需手动调整

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