SDL3 游戏开发 Windows 环境搭建

monzaid

已于 2025-03-25 21:32:58 修改

阅读量1k

点赞数 10

分类专栏： C++游戏文章标签： windows sdl

于 2025-03-16 12:37:31 首次发布

本文链接：https://blog.youkuaiyun.com/ymxyld/article/details/146293411

版权

C++游戏专栏收录该内容

3 篇文章

订阅专栏

SDL3 游戏开发 Windows 环境搭建

一、准备工作

1.1 必备工具与库安装

1.1.1 CMake

官网下载：访问 CMake 官方网站，根据操作系统选择相应版本进行下载。
安装步骤：
- 运行安装程序，选择安装路径。
- 在安装过程中，勾选 “Add CMake to the system PATH” 选项，确保 CMake 添加到系统路径。或者手动添加到系统环境变量 PATH 中。
- 完成安装后，在终端中输入 cmake --version 验证安装是否成功。

1.1.2 MinGW-w64

版本选择：MinGW 官网地址，MinGW-W64-builds，下载最新版本（x86_64-14.2.0-release-win32-seh-ucrt-rt_v12-rev1）。
安装步骤：
- 解压下载的文件到指定目录，例如 C:\mingw64。
- 将 C:\mingw64\bin 添加到系统环境变量 PATH 中。
- 在终端中输入 g++ --version 验证安装是否成功。

1.1.3 Ninja

官网获取：访问 Ninja 官方网站，下载最新版本的 Ninja。
安装步骤：
- 将下载的 Ninja 文件解压到指定目录，例如 C:\ninja。
- 将 C:\ninja 添加到系统环境变量 PATH 中。
- 在终端中输入 ninja --version 验证安装是否成功。

1.1.4 Git

官网安装：访问 Git 官方网站，下载并安装官方版本。
安装步骤：
- 运行安装程序，选择安装路径。
- 在安装过程中，选择 “Use Git from the Windows Command Prompt” 选项，以便在终端中使用 Git。
- 完成安装后，在终端中输入 git --version 验证安装是否成功。

1.1.5 SDL3 及扩展库

SDL3 下载：查看最新版本的SDL库：SDL。
安装步骤：
- 方法一：下载源码编译：下载最新版本的源码压缩包，解压源码文件，使用 CMake 配置项目，运行编译命令，生成 SDL 库文件。
- 方法二：下载 devel-vc 的压缩包解压：将下载的 SDL3 devel-vc 版本压缩包解压至 C:\myProjects\Library\SDL3。
- 将库文件夹 C:\myProjects\Library\SDL3\lib\x64 添加到系统环境变量 PATH 中。
注意：
- 头文件和库文件路径：在游戏项目中配置CMakeLists.txt时，确保正确指定SDL3的头文件（include）和库文件(lib)路径。如果使用find_package，则需要确保SDL3的cmake目录路径正确。
扩展库安装：根据项目需求，选择安装 SDL_image，SDL_mixer，SDL_ttf 和 GLM。这些库可以从各自的官方网站或开源平台下载，并按照官方文档进行安装和配置。

1.1.6 VSCode 及插件

安装 VSCode：访问 Visual Studio Code 官方网站，下载并安装最新版本。
安装插件：打开 VSCode，点击左侧活动栏中的扩展视图，搜索并安装 “C/C++ Extension Pack”。
- 在编译器下面状态栏显示CMake Status Bar：设置->cmake Status Bar->Visible。
- 选择合适的编译器工具链：可以通过Ctrl + Shift + P调出命令面板，输入CMake: Select a Kit来选择合适的编译器工具链。

二、配置VSCode项目并验证环境

2.1 创建测试源文件

在 C:\myProjects\gameDamo 目录下创建 main.cpp 文件，编写一个简单的 SDL3 测试程序，用于验证环境配置是否正确。该程序将初始化 SDL、创建一个窗口，以确保 SDL3 库能够正常工作。

#include <SDL3/SDL.h>

int main(int argc, char* argv[]) {
    // 初始化SDL
    if (SDL_Init(SDL_INIT_VIDEO) < 0) {
        SDL_Log("Unable to initialize SDL: %s", SDL_GetError());
        return -1;
    }

    // 创建窗口
    SDL_Window* window = SDL_CreateWindow("SDL3 Test", 640, 480, SDL_WINDOW_OPENGL);
    if (!window) {
        SDL_Log("Unable to create window: %s", SDL_GetError());
        SDL_Quit();
        return -1;
    }

    // 主循环
    bool running = true;
    while (running) {
        SDL_Event event;
        while (SDL_PollEvent(&event)) {
            if (event.type == SDL_EVENT_QUIT) {
                running = false;
            }
        }
    }

    // 释放资源
    SDL_DestroyWindow(window);
    SDL_Quit();

    return 0;
}

2.2 编写CMakeLists.txt文件和CMakePresets.json

2.2.1 使用VSCode的CMake Quick Start

VSCode的CMake Tools扩展提供了快速开始功能，可以自动生成CMakeLists.txt和CMakePresets.json文件。通过以下步骤创建项目：

打开VSCode，进入项目目录C:\myProjects\gameDamo。
按Ctrl + Shift + P，调出命令面板。
输入CMake: Quick Start，选择它。
按提示填写项目名称、语言等信息，VSCode将自动生成CMakeLists.txt和CMakePresets.json文件。

2.2.2 手动编写CMakeLists.txt文件

VSCode的CMake Quick Start自动生成CMakeLists.txt文件，只是生成了一个默认的模板文件，需要手动编写CMakeLists.txt文件，指定SDL3的头文件、库文件路径和链接SDL3库：

cmake_minimum_required(VERSION 3.10.0)
project(gameDamo VERSION 0.1.0 LANGUAGES C CXX)

# 指定SDL3的头文件路径
include_directories("C:\\myProjects\\Library\\SDL3\\include")
# 指定SDL3的库文件路径
link_directories("C:\\myProjects\\Library\\SDL3\\lib\\x64")

# 添加可执行文件
add_executable(gameDamo main.cpp)

# 链接SDL3库
target_link_libraries(gameDamo SDL3)

除了前面提到的写法，CMakeLists.txt也可以这样写，如果库里有cmake文件夹，使用find_package来指定路径和查找SDL3库：

cmake_minimum_required(VERSION 3.10.0)
project(gameDamo VERSION 0.1.0 LANGUAGES C CXX)

# 设置SDL3的CMake模块路径
set(SDL3_DIR "C:/myProjects/Library/SDL3/cmake")
# 查找SDL3库
find_package(SDL3 REQUIRED)

# 添加可执行文件
add_executable(gameDamo main.cpp)

# 链接SDL3库
target_link_libraries(gameDamo SDL3::SDL3)

2.2.3 手动编写CMakePresets.json文件

VSCode的CMake Tools扩展会自动生成CMakePresets.json文件，其中定义了项目的构建配置。默认情况下，它会设置生成器、构建目录等参数。如果需要自定义配置，可以手动编辑该文件。

{
    "version": 8,
    "configurePresets": [
        {
            "name": "Configure preset using toolchain file",
            "displayName": "Configure preset using toolchain file",
            "description": "Sets Ninja generator, build and install directory",
            "generator": "Ninja",
            "binaryDir": "${sourceDir}/out/build/${presetName}",
            "cacheVariables": {
                "CMAKE_BUILD_TYPE": "Debug",
                "CMAKE_TOOLCHAIN_FILE": "",
                "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}"
            }
        }
    ]
}