SDL2 项目启动与配置教程

1. 项目的目录结构及介绍

SDL2 是一个跨平台的开发库，它提供了对音频、键盘、鼠标、摇杆和图形硬件的低级别访问。以下是 SDL2 项目的目录结构及其简要介绍：

• build-scripts：包含构建项目的脚本文件。
• cmake：存放 CMake 相关文件，用于构建项目。
• debian：包含用于在 Debian 系统上打包项目的文件。
• docs：存放项目文档。
• include：包含项目的头文件。
• src：存放项目的源代码。
• test：包含测试代码和测试用例。
• visualtest：包含用于可视化测试的代码。
• wayland-protocols：包含与 Wayland 显示服务器通信的协议文件。
• .gitignore、.hgignore、.hgtags：Git 和 Mercurial 仓库的忽略文件。
• Android.mk：用于 Android 平台构建的 Makefile。
• BUGS.txt、COPYING.txt、CREDITS.txt、INSTALL.txt、README.txt、TODO.txt、WhatsNew.txt：项目的元数据文件，包含项目信息、版权、授权、安装指南、更新日志等。
• Makefile.*：不同平台的 Makefile 文件。
• README-SDL.txt：SDL2 的介绍文件。
• SDL2.spec.in：用于生成特定发行版打包文件的模板。
• SDL2Config.cmake、sdl2-config.cmake.in、sdl2-config.in：CMake 和配置脚本文件。
• configure、configure.ac：自动配置脚本及其生成文件。
• sdl2.m4、sdl2.pc.in：用于生成编译器和打包工具的配置文件。

2. 项目的启动文件介绍

项目的启动文件通常是 src 目录下的 SDL.c 或 SDL2.c 文件。这个文件是 SDL2 库的入口点，它初始化了 SDL2 库，并提供了与平台无关的接口。

#include "SDL.h"

int main(int argc, char* argv[]) {
    SDL_Init(SDL_INIT_VIDEO);
    
    SDL_Window *window = SDL_CreateWindow("SDL2 Window",
                                         SDL_WINDOWPOS_UNDEFINED,
                                         SDL_WINDOWPOS_UNDEFINED,
                                         640, 480,
                                         SDL_WINDOW_SHOWN);
    if (window == NULL) {
        SDL_Log("Window could not be created! SDL_Error: %s", SDL_GetError());
    }
    
    // 在此处添加您的应用程序逻辑
    
    SDL_Delay(5000); // 等待 5000 毫秒（5秒）

    SDL_DestroyWindow(window);
    SDL_Quit();

    return 0;
}

这段代码创建了一个简单的窗口，并且在屏幕上显示 5 秒钟。

3. 项目的配置文件介绍

配置文件通常用于指定编译选项、依赖库和项目特性。在 SDL2 项目中，主要的配置文件是 CMakeLists.txt。

cmake_minimum_required(VERSION 3.0)
project(SDL2)

set(VERSION_MAJOR 2)
set(VERSION_MINOR 0)
set(VERSION_PATCH 0)

set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fPIC")

# 查找依赖
find_package(Threads REQUIRED)

# 定义库
add_library(SDL2
    src/SDL.c
    # ... 添加其他源文件
)

# 设置版本和 SO 版本
set_target_properties(SDL2 PROPERTIES
    VERSION ${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH}
    SOVERSION ${VERSION_MAJOR}
)

# 链接库
target_link_libraries(SDL2
    ${CMAKE_THREAD_LIBS_INIT}
    # ... 添加其他依赖库
)

# 安装规则
install(TARGETS SDL2
    RUNTIME DESTINATION bin
    LIBRARY DESTINATION lib
    ARCHIVE DESTINATION lib
)

# 导出目标
export(TARGETS SDL2
    FILE "${CMAKE_CURRENT_BINARY_DIR}/SDL2Targets.cmake"
)

# 配置安装文件
include(CMakePackageConfigHelpers)
configure_package_config_file(
    SDL2Config.cmake.in
    "${CMAKE_CURRENT_BINARY_DIR}/SDL2Config.cmake"
    INSTALLDestination lib/cmake/SDL2
)

# 安装配置文件
install(FILES
    "${CMAKE_CURRENT_BINARY_DIR}/SDL2Config.cmake"
    DESTINATION lib/cmake/SDL2
)

这个配置文件指定了项目的最小 CMake 版本要求、项目名称和版本。它还定义了库的源文件、版本和 SO 版本，并且指定了链接库和安装规则。最后，它还导出了目标并配置了安装文件。