SDL 3 新平台移植实战指南从平台注册到驱动实现【免费下载链接】SDLSimple DirectMedia Layer项目地址: https://gitcode.com/GitHub_Trending/sd/SDL本篇移植指南以 SDL 官方文档 docs/README-porting.md 为核心骨架结合当前 SDL 3 源码仓库中的平台检测、构建系统与 dummy 驱动实现系统讲解如何把一个全新的操作系统/硬件平台接入 SDL先在平台定义头文件中登记新平台的预处理器宏再通过 CMake 或自定义构建系统IDE两条路线完成编译最后按子系统逐个实现真实驱动。读完本文你将掌握 SDL 平台抽象层的完整接入流程并能在自己的项目里落地一套可编译、可运行、可逐步完善的移植方案。一、移植的整体思路先识别平台再构建最后实现驱动SDL 的移植过程可以划分为三个层层递进的阶段这也是原文档docs/README-porting.md的核心脉络平台识别Platform Identification让 SDL 在编译期能认出你的操作系统通过统一的SDL_PLATFORM_X宏把平台差异收敛到预处理器层构建接入Build Integration通过 CMake 或 IDE/自定义构建系统把 SDL 源码编译成库先用 dummy 驱动得到一个无硬件依赖的可用库驱动实现Driver Implementation在库能跑起来之后回到音频、视频、事件、手柄等子系统逐一编写目标平台的真实后端驱动。原文档明确强调一旦你有了一个不含任何驱动也能工作的库就可以回到各个主要子系统开始为你的平台实现驱动。也就是说dummy 驱动只是移植的起点不是终点它保证了库的骨架先立起来后续每个子系统的真实驱动可以独立推进、互不阻塞。二、第一步在平台定义头文件中注册你的操作系统2.1 宏命名规范与检测原理原文档指出移植的第一步是查看include/SDL_platform.h并为操作系统创建条目标准格式为SDL_PLATFORM_XX 为操作系统名。在当前的 SDL 3 仓库中该职责由两个文件分担include/SDL3/SDL_platform.h声明平台相关 APICategoryPlatform提供运行时平台识别能力SDL_GetPlatform()所在的头文件include/SDL3/SDL_platform_defines.h定义编译期平台宏即真正登记新平台的位置。平台检测的核心理念是基于 C 预处理器符号自动识别而不是依赖构建系统手工传入参数。例如SDL_platform_defines.h中的典型实现/* LinuxAndroid 虽然基于 Linux 内核但不会定义此宏而会定义 SDL_PLATFORM_ANDROID */ #if (defined(linux) || defined(__linux) || defined(__linux__)) #define SDL_PLATFORM_LINUX 1 #endif /* Android 会显式覆盖上面的 Linux 定义 */ #if defined(ANDROID) || defined(__ANDROID__) #define SDL_PLATFORM_ANDROID 1 #undef SDL_PLATFORM_LINUX #endif这种由编译器/平台 SDK 自带宏驱动的设计意味着只要目标平台的工具链在其标准头文件或命令行中预定义了对应符号SDL 就能在没有任何手工配置的情况下自动选中正确的平台分支。2.2 当前仓库已注册的平台宏从 include/SDL3/SDL_platform_defines.h全文 507 行可以看到目前已注册的平台宏每个宏均以SDL_PLATFORM_为前缀预处理器宏触发条件示例含义SDL_PLATFORM_AIX_AIXIBM AIXSDL_PLATFORM_HAIKU__HAIKU__Haiku OSSDL_PLATFORM_BSDIbsdi/__bsdi/__bsdi__BSD/OSSDL_PLATFORM_FREEBSD__FreeBSD__/__FreeBSD_kernel__/__DragonFly__FreeBSD / DragonFlySDL_PLATFORM_HPUXhpux/__hpux/__hpux__HP-UXSDL_PLATFORM_IRIXsgi/__sgi/__sgi__/_SGI_SOURCEIRIXSDL_PLATFORM_LINUXlinux/__linux/__linux__LinuxSDL_PLATFORM_ANDROIDANDROID/__ANDROID__Android并取消 LINUXSDL_PLATFORM_UNIX__unix__/__unix/unixUnix 类系统可与其他宏并存SDL_PLATFORM_APPLE__APPLE__Apple 全系macOS/iOS/tvOS/visionOS 的上位宏SDL_PLATFORM_MACOS、SDL_PLATFORM_IOS、SDL_PLATFORM_TVOS、SDL_PLATFORM_VISIONOS在 Apple 分支内进一步细分具体 Apple 平台此外还有 Apple 平台特有的细节SDL_PLATFORM_APPLE定义后会通过AvailabilityMacros.h、TargetConditionals.h等系统头文件继续细分出具体平台。注意区分几个层级SDL_PLATFORM_UNIX是宽泛的 Unix 标记Linux 同时也会定义它而SDL_PLATFORM_LINUX才是精确的 Linux 标记Android 定义SDL_PLATFORM_ANDROID的同时会#undef SDL_PLATFORM_LINUX避免被误判为桌面 Linux。2.3 如何新增一个平台按照原文档的指引新增平台的操作步骤为在 include/SDL3/SDL_platform_defines.h 中新增一段#if/#define格式为SDL_PLATFORM_YOUR_OS 1触发条件优先选择目标平台工具链已预定义的标准符号如__MYOS__这样编译器自动就能识别无需构建系统额外传参若新平台与已有平台存在继承关系如基于 Unix 内核参考 Android 的做法先定义宽泛宏再定义精确宏必要时#undef掉不准确的宏同时可以在 include/SDL3/SDL_platform.h 的运行时 API 侧补充SDL_GetPlatform()返回的字符串使运行时也能报告新平台名。三、构建接入的两种基本方式原文档明确指出当前 SDL 有两种基本构建方式选择哪种取决于目标平台是否已有 CMake 工具链支持方式适用场景入口CMake平台已有 CMake 支持CMakeLists.txtIDE / 自定义构建系统使用 Visual Studio、Xcode 等 IDE或平台自带专用构建流程include/build_config/SDL_build_config.h3.1 方式一CMake 构建原文档给出的 CMake 构建命令为cmake -S . -B build cmake --build build cmake --install install三段命令分别完成配置configure→ 编译build→ 安装installcmake -S . -B build以仓库根目录为源码目录-S .在build/目录生成构建系统cmake --build build执行实际编译cmake --install install将产物安装到install目录如需指定路径可追加--prefix 目录若使用cmake --install也可在配置阶段用-DCMAKE_INSTALL_PREFIX预设。如果平台支持 CMake移植工作的重点在于编辑根目录 CMakeLists.txt。原文档特别提示找到其中标注为Platform-specific options and settings的大段区域。该标记在当前仓库中位于 CMakeLists.txt其下是各平台的条件配置块例如 Android 块会# Platform-specific options and settings if(ANDROID) list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/cmake/android) sdl_glob_sources( ${SDL3_SOURCE_DIR}/src/core/android/*.c ${SDL3_SOURCE_DIR}/src/core/android/*.h ) sdl_link_dependency(android_core LIBS dl log android) # ... endif()从源码结构看平台配置块通常包含三类工作收集平台专属源码通过sdl_glob_sources(...)把src/subsystem/platform/下的.c/.h加入构建链接平台依赖库通过sdl_link_dependency(...)声明需要的系统库如 Android 的dl、log、android设置驱动开关如set(SDL_AUDIO_DRIVER_OPENSLES 1)、set(SDL_FILESYSTEM_ANDROID 1)等决定启用哪些子系统驱动。平台检测逻辑由 cmake/sdlplatform.cmake 中的SDL_DetectCMakePlatform()函数完成它把 CMake 层面的WIN32、APPLE、CMAKE_SYSTEM_NAME等信息映射为Windows、macOS、iOS、tvOS、watchOS、visionOS、Haiku、n3ds、dos等平台标识再与 cmake/sdlplatform.cmake 顶部的分支配合决定平台配置块。因此新增平台时若工具链的CMAKE_SYSTEM_NAME无法被现有分支覆盖还需要在这里补充识别逻辑。修改完成后重新执行cmake -S . -B build并构建即可。注意 CMake 是增量配置的新增平台分支后建议清理build/目录或使用新的构建目录避免旧缓存干扰。3.2 方式二IDE / 自定义构建系统如果使用 IDEVisual Studio、Xcode 等或平台自带的非 CMake 构建系统原文档给出的路线是定制SDL_build_config.h编辑 include/build_config/SDL_build_config.h为你的平台新增一个条件分支基于 include/build_config/SDL_build_config_minimal.h 和 include/build_config/SDL_build_config.h.cmake 创建自定义的SDL_build_config_{platform}.h把仓库顶层include/目录加入头文件搜索路径把下述源码列表加入工程。当前仓库 include/build_config/ 目录下已经沉淀了各平台的参考实现SDL_build_config_android.h、SDL_build_config_ios.h、SDL_build_config_macos.h、SDL_build_config_windows.h、SDL_build_config_wingdk.h、SDL_build_config_xbox.h、SDL_build_config_minimal.h。其中SDL_build_config_minimal.h是最小可用配置模板其头注释即说明This is the minimal configuration that can be used to build SDL。它只声明极少的系统能力并默认把所有子系统切换为 dummy/stub 驱动/* Enable the dummy audio driver (src/audio/dummy/\*.c) */ #define SDL_AUDIO_DRIVER_DUMMY 1 /* Enable the stub joystick driver (src/joystick/dummy/\*.c) */ #define SDL_JOYSTICK_DISABLED 1 /* Enable the dummy video driver (src/video/dummy/\*.c) */ #define SDL_VIDEO_DRIVER_DUMMY 1 /* Enable the dummy filesystem driver (src/filesystem/dummy/\*.c) */ #define SDL_FILESYSTEM_DUMMY 1 /* Enable the dummy shared object loader (src/loadso/dummy/\*.c) */ #define SDL_LOADSO_DUMMY 1 /* Enable the stub thread support (src/thread/generic/\*.c) */ #define SDL_THREADS_DISABLED 1这组宏非常直观地体现了先用空驱动把库编译出来再逐个替换为真实驱动的移植策略*_DUMMY/*_DISABLED系列开关与源码目录一一对应打开开关即引入对应子系统的占位实现。SDL_build_config_minimal.h中还包含基础能力声明例如HAVE_STDARG_H、HAVE_STDDEF_H、HAVE_STDINT_H并对 Visual Studio 2008 及更早版本做了stdint.h缺失的兼容处理——这提示我们在为新平台定制配置时需要根据平台 C 库实际情况增删这些HAVE_*能力宏。四、加入工程的最小源码清单完整继承原文档给出了把 SDL 加入 IDE/自定义构建系统时需要添加的源码清单这是无驱动可编译的关键一步。以下为原文完整清单其中src/file/*.c在 SDL 3 仓库中已更名为src/filesystem/*.c路径以当前仓库为准src/*.c src/atomic/*.c src/audio/*.c src/cpuinfo/*.c src/events/*.c src/filesystem/*.c # 原文档为 src/file/*.c仓库结构调整后改名 src/haptic/*.c src/joystick/*.c src/power/*.c src/render/*.c src/render/software/*.c src/stdlib/*.c src/thread/*.c src/timer/*.c src/video/*.c src/audio/disk/*.c src/audio/dummy/*.c src/filesystem/dummy/*.c src/video/dummy/*.c src/haptic/dummy/*.c src/joystick/dummy/*.c src/thread/generic/*.c src/timer/dummy/*.c src/loadso/dummy/*.c清单的前半部分是各子系统的平台无关核心层src/atomic、src/events、src/render、src/stdlib、src/video等后半部分是dummy/stub 占位驱动。这些目录在 src/ 下均可找到对应实现例如 dummy 视频驱动位于 src/video/dummy/其中 src/video/dummy/SDL_nullvideo.c 以#ifdef SDL_VIDEO_DRIVER_DUMMY保护整个实现并注册驱动名为dummy的SDL dummy video driver。关于清单的几点说明原文档列出的src/file/*.c在 SDL 3 中已迁移为src/filesystem/*.c文件系统子系统移植时请使用当前路径除文档列出的 dummy 驱动外src/下还有camera/dummy、dialog/dummy、sensor/dummy等较新子系统的占位实现见 include/build_config/SDL_build_config_minimal.h 中的SDL_CAMERA_DRIVER_DUMMY、SDL_DIALOG_DUMMY、SDL_SENSOR_DISABLED等开关新平台可根据需要一并纳入头文件搜索路径只需添加顶层include/因为头文件通过#include SDL3/SDL.h方式组织include/SDL3/ 下的各子系统头文件会被SDL.h统一包含。五、驱动实现路线从 dummy 到真实后端5.1 为什么要先做 dummy 版本原文档的核心建议是先把库编译到一个没有任何驱动的状态。其价值在于尽早验证平台识别、构建系统、工具链是否工作正常隔离问题域——编译不过时问题几乎必然出在构建接入环节而非驱动代码让事件循环、SDL 核心 API 先在新平台上活起来为后续驱动的开发提供可测试的宿主。dummy 驱动的实现模式非常统一整个.c文件用对应的SDL_*_DUMMY宏包裹注册一个最小化的驱动实例。以 src/video/dummy/SDL_nullvideo.c 为例其驱动名称为DUMMYVID_DRIVER_NAME即dummy对外暴露为SDL dummy video driverSDL_nullframebuffer.c、SDL_nullevents.c则提供最小化的帧缓冲与事件占位。类似地src/audio/dummy/、src/filesystem/dummy/、src/thread/generic/等目录都遵循宏保护 最小实现 可被上层查询的模式。5.2 按子系统逐个实现驱动库能编译运行后就可以回到每个主要子系统开始为平台实现驱动原文。SDL 子系统驱动的实现通常遵循以下流程确认子系统架构阅读该子系统在 src/ 下的SDL_subsystem.c与SDL_syssubsystem.h如 src/video/ 下的SDL_video.c与SDL_sysvideo.h理解后端驱动的注册与回调接口参考同类型平台例如新平台若类 Unix可参考 src/video/ 下 X11/Wayland/KMSDRM 驱动的组织方式若是新移动平台可参考 Android/iOS 驱动创建平台子目录在src/subsystem/platform/下编写驱动源码并在SDL_build_config_{platform}.hIDE 路线或 CMakeLists.txt 平台配置块CMake 路线中打开对应开关、加入源码、链接平台库逐子系统替换 dummy每完成一个子系统如先做 timer、filesystem再做 video、audio、joystick就把构建配置中的*_DUMMY/*_DISABLED换成真实驱动开关保持库始终可编译、可测试。5.3 常用驱动开关速查结合 include/build_config/SDL_build_config_minimal.h 与各子系统源码移植过程中最常见的配置开关包括配置宏作用对应源码目录SDL_AUDIO_DRIVER_DUMMY启用 dummy 音频驱动src/audio/dummy/SDL_VIDEO_DRIVER_DUMMY启用 dummy 视频驱动src/video/dummy/SDL_FILESYSTEM_DUMMY/SDL_FSOPS_DUMMY启用 dummy 文件系统驱动src/filesystem/dummy/SDL_JOYSTICK_DISABLED关闭手柄子系统stubsrc/joystick/SDL_HAPTIC_DISABLED关闭力反馈子系统stubsrc/haptic/SDL_HIDAPI_DISABLED关闭 HIDAPIsrc/hidapi/SDL_LOADSO_DUMMY启用 dummy 动态库加载器src/loadso/SDL_THREADS_DISABLED关闭线程支持stubsrc/thread/SDL_SENSOR_DISABLED关闭传感器子系统src/sensor/SDL_PROCESS_DUMMY启用 dummy 进程支持src/process/SDL_CAMERA_DRIVER_DUMMY启用 dummy 摄像头驱动src/camera/dummy/SDL_DIALOG_DUMMY/SDL_TRAY_DUMMY启用 dummy 对话框/托盘支持src/dialog/ / src/tray/原则是开始阶段全部用*_DUMMY/*_DISABLED随后按子系统逐项换成真实实现。六、移植检查清单综合原文档与当前仓库结构一份可操作的新平台移植检查清单如下阶段一平台识别在 include/SDL3/SDL_platform_defines.h 中定义SDL_PLATFORM_你的平台触发条件使用工具链标准预定义符号确认新平台宏不会与既有宏冲突参考 Android 覆盖 Linux 的做法可选在 include/SDL3/SDL_platform.h 的运行时 API 中补充平台名。阶段二构建接入选择 CMake 或 IDE 路线CMake 路线在 CMakeLists.txt 的 Platform-specific options and settings 段#L1487添加平台块必要时在 cmake/sdlplatform.cmake 补充平台识别IDE 路线基于 include/build_config/SDL_build_config_minimal.h 与 include/build_config/SDL_build_config.h.cmake 创建SDL_build_config_platform.h并在 include/build_config/SDL_build_config.h 挂载将顶层include/加入头文件搜索路径按第四节清单把核心层 dummy 驱动源码加入工程成功编译出无驱动版 SDL 库。阶段三驱动实现从 timer / filesystem 等低依赖子系统开始逐个替换 dummy 为真实驱动每个子系统实现后更新构建配置中的驱动开关并回归编译最后处理 video、audio 等与硬件耦合较深的子系统。七、结语移植 SDL 到新平台并非无迹可循的工程注册SDL_PLATFORM_X宏让平台被识别通过 CMake 或 IDE 路线先得到空驱动的可用库再以 include/build_config/SDL_build_config_minimal.h 为最小参考、以各子系统源码为模板逐个实现真实驱动——这就是 docs/README-porting.md 给出的完整路径。对于与 Linux 同源的新系统可重点参考仓库中现有 Unix 系驱动对于全新平台则建议从 dummy 逐步过渡始终保持库可编译、可运行、可增量验证。如需进一步了解 SDL 的平台体系可在仓库内继续阅读 include/SDL3/SDL_platform.h、include/SDL3/SDL_platform_defines.h、docs/README-platforms.md 以及 README.md构建与安装细节可参考 docs/README-cmake.md 和 docs/INTRO-cmake.md。【免费下载链接】SDLSimple DirectMedia Layer项目地址: https://gitcode.com/GitHub_Trending/sd/SDL创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 SDL 3 新平台移植实战指南：从平台注册到驱动实现
SDL 3 新平台移植实战指南从平台注册到驱动实现【免费下载链接】SDLSimple DirectMedia Layer项目地址: https://gitcode.com/GitHub_Trending/sd/SDL本篇移植指南以 SDL 官方文档 docs/README-porting.md 为核心骨架结合当前 SDL 3 源码仓库中的平台检测、构建系统与 dummy 驱动实现系统讲解如何把一个全新的操作系统/硬件平台接入 SDL先在平台定义头文件中登记新平台的预处理器宏再通过 CMake 或自定义构建系统IDE两条路线完成编译最后按子系统逐个实现真实驱动。读完本文你将掌握 SDL 平台抽象层的完整接入流程并能在自己的项目里落地一套可编译、可运行、可逐步完善的移植方案。一、移植的整体思路先识别平台再构建最后实现驱动SDL 的移植过程可以划分为三个层层递进的阶段这也是原文档docs/README-porting.md的核心脉络平台识别Platform Identification让 SDL 在编译期能认出你的操作系统通过统一的SDL_PLATFORM_X宏把平台差异收敛到预处理器层构建接入Build Integration通过 CMake 或 IDE/自定义构建系统把 SDL 源码编译成库先用 dummy 驱动得到一个无硬件依赖的可用库驱动实现Driver Implementation在库能跑起来之后回到音频、视频、事件、手柄等子系统逐一编写目标平台的真实后端驱动。原文档明确强调一旦你有了一个不含任何驱动也能工作的库就可以回到各个主要子系统开始为你的平台实现驱动。也就是说dummy 驱动只是移植的起点不是终点它保证了库的骨架先立起来后续每个子系统的真实驱动可以独立推进、互不阻塞。二、第一步在平台定义头文件中注册你的操作系统2.1 宏命名规范与检测原理原文档指出移植的第一步是查看include/SDL_platform.h并为操作系统创建条目标准格式为SDL_PLATFORM_XX 为操作系统名。在当前的 SDL 3 仓库中该职责由两个文件分担include/SDL3/SDL_platform.h声明平台相关 APICategoryPlatform提供运行时平台识别能力SDL_GetPlatform()所在的头文件include/SDL3/SDL_platform_defines.h定义编译期平台宏即真正登记新平台的位置。平台检测的核心理念是基于 C 预处理器符号自动识别而不是依赖构建系统手工传入参数。例如SDL_platform_defines.h中的典型实现/* LinuxAndroid 虽然基于 Linux 内核但不会定义此宏而会定义 SDL_PLATFORM_ANDROID */ #if (defined(linux) || defined(__linux) || defined(__linux__)) #define SDL_PLATFORM_LINUX 1 #endif /* Android 会显式覆盖上面的 Linux 定义 */ #if defined(ANDROID) || defined(__ANDROID__) #define SDL_PLATFORM_ANDROID 1 #undef SDL_PLATFORM_LINUX #endif这种由编译器/平台 SDK 自带宏驱动的设计意味着只要目标平台的工具链在其标准头文件或命令行中预定义了对应符号SDL 就能在没有任何手工配置的情况下自动选中正确的平台分支。2.2 当前仓库已注册的平台宏从 include/SDL3/SDL_platform_defines.h全文 507 行可以看到目前已注册的平台宏每个宏均以SDL_PLATFORM_为前缀预处理器宏触发条件示例含义SDL_PLATFORM_AIX_AIXIBM AIXSDL_PLATFORM_HAIKU__HAIKU__Haiku OSSDL_PLATFORM_BSDIbsdi/__bsdi/__bsdi__BSD/OSSDL_PLATFORM_FREEBSD__FreeBSD__/__FreeBSD_kernel__/__DragonFly__FreeBSD / DragonFlySDL_PLATFORM_HPUXhpux/__hpux/__hpux__HP-UXSDL_PLATFORM_IRIXsgi/__sgi/__sgi__/_SGI_SOURCEIRIXSDL_PLATFORM_LINUXlinux/__linux/__linux__LinuxSDL_PLATFORM_ANDROIDANDROID/__ANDROID__Android并取消 LINUXSDL_PLATFORM_UNIX__unix__/__unix/unixUnix 类系统可与其他宏并存SDL_PLATFORM_APPLE__APPLE__Apple 全系macOS/iOS/tvOS/visionOS 的上位宏SDL_PLATFORM_MACOS、SDL_PLATFORM_IOS、SDL_PLATFORM_TVOS、SDL_PLATFORM_VISIONOS在 Apple 分支内进一步细分具体 Apple 平台此外还有 Apple 平台特有的细节SDL_PLATFORM_APPLE定义后会通过AvailabilityMacros.h、TargetConditionals.h等系统头文件继续细分出具体平台。注意区分几个层级SDL_PLATFORM_UNIX是宽泛的 Unix 标记Linux 同时也会定义它而SDL_PLATFORM_LINUX才是精确的 Linux 标记Android 定义SDL_PLATFORM_ANDROID的同时会#undef SDL_PLATFORM_LINUX避免被误判为桌面 Linux。2.3 如何新增一个平台按照原文档的指引新增平台的操作步骤为在 include/SDL3/SDL_platform_defines.h 中新增一段#if/#define格式为SDL_PLATFORM_YOUR_OS 1触发条件优先选择目标平台工具链已预定义的标准符号如__MYOS__这样编译器自动就能识别无需构建系统额外传参若新平台与已有平台存在继承关系如基于 Unix 内核参考 Android 的做法先定义宽泛宏再定义精确宏必要时#undef掉不准确的宏同时可以在 include/SDL3/SDL_platform.h 的运行时 API 侧补充SDL_GetPlatform()返回的字符串使运行时也能报告新平台名。三、构建接入的两种基本方式原文档明确指出当前 SDL 有两种基本构建方式选择哪种取决于目标平台是否已有 CMake 工具链支持方式适用场景入口CMake平台已有 CMake 支持CMakeLists.txtIDE / 自定义构建系统使用 Visual Studio、Xcode 等 IDE或平台自带专用构建流程include/build_config/SDL_build_config.h3.1 方式一CMake 构建原文档给出的 CMake 构建命令为cmake -S . -B build cmake --build build cmake --install install三段命令分别完成配置configure→ 编译build→ 安装installcmake -S . -B build以仓库根目录为源码目录-S .在build/目录生成构建系统cmake --build build执行实际编译cmake --install install将产物安装到install目录如需指定路径可追加--prefix 目录若使用cmake --install也可在配置阶段用-DCMAKE_INSTALL_PREFIX预设。如果平台支持 CMake移植工作的重点在于编辑根目录 CMakeLists.txt。原文档特别提示找到其中标注为Platform-specific options and settings的大段区域。该标记在当前仓库中位于 CMakeLists.txt其下是各平台的条件配置块例如 Android 块会# Platform-specific options and settings if(ANDROID) list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/cmake/android) sdl_glob_sources( ${SDL3_SOURCE_DIR}/src/core/android/*.c ${SDL3_SOURCE_DIR}/src/core/android/*.h ) sdl_link_dependency(android_core LIBS dl log android) # ... endif()从源码结构看平台配置块通常包含三类工作收集平台专属源码通过sdl_glob_sources(...)把src/subsystem/platform/下的.c/.h加入构建链接平台依赖库通过sdl_link_dependency(...)声明需要的系统库如 Android 的dl、log、android设置驱动开关如set(SDL_AUDIO_DRIVER_OPENSLES 1)、set(SDL_FILESYSTEM_ANDROID 1)等决定启用哪些子系统驱动。平台检测逻辑由 cmake/sdlplatform.cmake 中的SDL_DetectCMakePlatform()函数完成它把 CMake 层面的WIN32、APPLE、CMAKE_SYSTEM_NAME等信息映射为Windows、macOS、iOS、tvOS、watchOS、visionOS、Haiku、n3ds、dos等平台标识再与 cmake/sdlplatform.cmake 顶部的分支配合决定平台配置块。因此新增平台时若工具链的CMAKE_SYSTEM_NAME无法被现有分支覆盖还需要在这里补充识别逻辑。修改完成后重新执行cmake -S . -B build并构建即可。注意 CMake 是增量配置的新增平台分支后建议清理build/目录或使用新的构建目录避免旧缓存干扰。3.2 方式二IDE / 自定义构建系统如果使用 IDEVisual Studio、Xcode 等或平台自带的非 CMake 构建系统原文档给出的路线是定制SDL_build_config.h编辑 include/build_config/SDL_build_config.h为你的平台新增一个条件分支基于 include/build_config/SDL_build_config_minimal.h 和 include/build_config/SDL_build_config.h.cmake 创建自定义的SDL_build_config_{platform}.h把仓库顶层include/目录加入头文件搜索路径把下述源码列表加入工程。当前仓库 include/build_config/ 目录下已经沉淀了各平台的参考实现SDL_build_config_android.h、SDL_build_config_ios.h、SDL_build_config_macos.h、SDL_build_config_windows.h、SDL_build_config_wingdk.h、SDL_build_config_xbox.h、SDL_build_config_minimal.h。其中SDL_build_config_minimal.h是最小可用配置模板其头注释即说明This is the minimal configuration that can be used to build SDL。它只声明极少的系统能力并默认把所有子系统切换为 dummy/stub 驱动/* Enable the dummy audio driver (src/audio/dummy/\*.c) */ #define SDL_AUDIO_DRIVER_DUMMY 1 /* Enable the stub joystick driver (src/joystick/dummy/\*.c) */ #define SDL_JOYSTICK_DISABLED 1 /* Enable the dummy video driver (src/video/dummy/\*.c) */ #define SDL_VIDEO_DRIVER_DUMMY 1 /* Enable the dummy filesystem driver (src/filesystem/dummy/\*.c) */ #define SDL_FILESYSTEM_DUMMY 1 /* Enable the dummy shared object loader (src/loadso/dummy/\*.c) */ #define SDL_LOADSO_DUMMY 1 /* Enable the stub thread support (src/thread/generic/\*.c) */ #define SDL_THREADS_DISABLED 1这组宏非常直观地体现了先用空驱动把库编译出来再逐个替换为真实驱动的移植策略*_DUMMY/*_DISABLED系列开关与源码目录一一对应打开开关即引入对应子系统的占位实现。SDL_build_config_minimal.h中还包含基础能力声明例如HAVE_STDARG_H、HAVE_STDDEF_H、HAVE_STDINT_H并对 Visual Studio 2008 及更早版本做了stdint.h缺失的兼容处理——这提示我们在为新平台定制配置时需要根据平台 C 库实际情况增删这些HAVE_*能力宏。四、加入工程的最小源码清单完整继承原文档给出了把 SDL 加入 IDE/自定义构建系统时需要添加的源码清单这是无驱动可编译的关键一步。以下为原文完整清单其中src/file/*.c在 SDL 3 仓库中已更名为src/filesystem/*.c路径以当前仓库为准src/*.c src/atomic/*.c src/audio/*.c src/cpuinfo/*.c src/events/*.c src/filesystem/*.c # 原文档为 src/file/*.c仓库结构调整后改名 src/haptic/*.c src/joystick/*.c src/power/*.c src/render/*.c src/render/software/*.c src/stdlib/*.c src/thread/*.c src/timer/*.c src/video/*.c src/audio/disk/*.c src/audio/dummy/*.c src/filesystem/dummy/*.c src/video/dummy/*.c src/haptic/dummy/*.c src/joystick/dummy/*.c src/thread/generic/*.c src/timer/dummy/*.c src/loadso/dummy/*.c清单的前半部分是各子系统的平台无关核心层src/atomic、src/events、src/render、src/stdlib、src/video等后半部分是dummy/stub 占位驱动。这些目录在 src/ 下均可找到对应实现例如 dummy 视频驱动位于 src/video/dummy/其中 src/video/dummy/SDL_nullvideo.c 以#ifdef SDL_VIDEO_DRIVER_DUMMY保护整个实现并注册驱动名为dummy的SDL dummy video driver。关于清单的几点说明原文档列出的src/file/*.c在 SDL 3 中已迁移为src/filesystem/*.c文件系统子系统移植时请使用当前路径除文档列出的 dummy 驱动外src/下还有camera/dummy、dialog/dummy、sensor/dummy等较新子系统的占位实现见 include/build_config/SDL_build_config_minimal.h 中的SDL_CAMERA_DRIVER_DUMMY、SDL_DIALOG_DUMMY、SDL_SENSOR_DISABLED等开关新平台可根据需要一并纳入头文件搜索路径只需添加顶层include/因为头文件通过#include SDL3/SDL.h方式组织include/SDL3/ 下的各子系统头文件会被SDL.h统一包含。五、驱动实现路线从 dummy 到真实后端5.1 为什么要先做 dummy 版本原文档的核心建议是先把库编译到一个没有任何驱动的状态。其价值在于尽早验证平台识别、构建系统、工具链是否工作正常隔离问题域——编译不过时问题几乎必然出在构建接入环节而非驱动代码让事件循环、SDL 核心 API 先在新平台上活起来为后续驱动的开发提供可测试的宿主。dummy 驱动的实现模式非常统一整个.c文件用对应的SDL_*_DUMMY宏包裹注册一个最小化的驱动实例。以 src/video/dummy/SDL_nullvideo.c 为例其驱动名称为DUMMYVID_DRIVER_NAME即dummy对外暴露为SDL dummy video driverSDL_nullframebuffer.c、SDL_nullevents.c则提供最小化的帧缓冲与事件占位。类似地src/audio/dummy/、src/filesystem/dummy/、src/thread/generic/等目录都遵循宏保护 最小实现 可被上层查询的模式。5.2 按子系统逐个实现驱动库能编译运行后就可以回到每个主要子系统开始为平台实现驱动原文。SDL 子系统驱动的实现通常遵循以下流程确认子系统架构阅读该子系统在 src/ 下的SDL_subsystem.c与SDL_syssubsystem.h如 src/video/ 下的SDL_video.c与SDL_sysvideo.h理解后端驱动的注册与回调接口参考同类型平台例如新平台若类 Unix可参考 src/video/ 下 X11/Wayland/KMSDRM 驱动的组织方式若是新移动平台可参考 Android/iOS 驱动创建平台子目录在src/subsystem/platform/下编写驱动源码并在SDL_build_config_{platform}.hIDE 路线或 CMakeLists.txt 平台配置块CMake 路线中打开对应开关、加入源码、链接平台库逐子系统替换 dummy每完成一个子系统如先做 timer、filesystem再做 video、audio、joystick就把构建配置中的*_DUMMY/*_DISABLED换成真实驱动开关保持库始终可编译、可测试。5.3 常用驱动开关速查结合 include/build_config/SDL_build_config_minimal.h 与各子系统源码移植过程中最常见的配置开关包括配置宏作用对应源码目录SDL_AUDIO_DRIVER_DUMMY启用 dummy 音频驱动src/audio/dummy/SDL_VIDEO_DRIVER_DUMMY启用 dummy 视频驱动src/video/dummy/SDL_FILESYSTEM_DUMMY/SDL_FSOPS_DUMMY启用 dummy 文件系统驱动src/filesystem/dummy/SDL_JOYSTICK_DISABLED关闭手柄子系统stubsrc/joystick/SDL_HAPTIC_DISABLED关闭力反馈子系统stubsrc/haptic/SDL_HIDAPI_DISABLED关闭 HIDAPIsrc/hidapi/SDL_LOADSO_DUMMY启用 dummy 动态库加载器src/loadso/SDL_THREADS_DISABLED关闭线程支持stubsrc/thread/SDL_SENSOR_DISABLED关闭传感器子系统src/sensor/SDL_PROCESS_DUMMY启用 dummy 进程支持src/process/SDL_CAMERA_DRIVER_DUMMY启用 dummy 摄像头驱动src/camera/dummy/SDL_DIALOG_DUMMY/SDL_TRAY_DUMMY启用 dummy 对话框/托盘支持src/dialog/ / src/tray/原则是开始阶段全部用*_DUMMY/*_DISABLED随后按子系统逐项换成真实实现。六、移植检查清单综合原文档与当前仓库结构一份可操作的新平台移植检查清单如下阶段一平台识别在 include/SDL3/SDL_platform_defines.h 中定义SDL_PLATFORM_你的平台触发条件使用工具链标准预定义符号确认新平台宏不会与既有宏冲突参考 Android 覆盖 Linux 的做法可选在 include/SDL3/SDL_platform.h 的运行时 API 中补充平台名。阶段二构建接入选择 CMake 或 IDE 路线CMake 路线在 CMakeLists.txt 的 Platform-specific options and settings 段#L1487添加平台块必要时在 cmake/sdlplatform.cmake 补充平台识别IDE 路线基于 include/build_config/SDL_build_config_minimal.h 与 include/build_config/SDL_build_config.h.cmake 创建SDL_build_config_platform.h并在 include/build_config/SDL_build_config.h 挂载将顶层include/加入头文件搜索路径按第四节清单把核心层 dummy 驱动源码加入工程成功编译出无驱动版 SDL 库。阶段三驱动实现从 timer / filesystem 等低依赖子系统开始逐个替换 dummy 为真实驱动每个子系统实现后更新构建配置中的驱动开关并回归编译最后处理 video、audio 等与硬件耦合较深的子系统。七、结语移植 SDL 到新平台并非无迹可循的工程注册SDL_PLATFORM_X宏让平台被识别通过 CMake 或 IDE 路线先得到空驱动的可用库再以 include/build_config/SDL_build_config_minimal.h 为最小参考、以各子系统源码为模板逐个实现真实驱动——这就是 docs/README-porting.md 给出的完整路径。对于与 Linux 同源的新系统可重点参考仓库中现有 Unix 系驱动对于全新平台则建议从 dummy 逐步过渡始终保持库可编译、可运行、可增量验证。如需进一步了解 SDL 的平台体系可在仓库内继续阅读 include/SDL3/SDL_platform.h、include/SDL3/SDL_platform_defines.h、docs/README-platforms.md 以及 README.md构建与安装细节可参考 docs/README-cmake.md 和 docs/INTRO-cmake.md。【免费下载链接】SDLSimple DirectMedia Layer项目地址: https://gitcode.com/GitHub_Trending/sd/SDL创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考