MacOS Sonoma下SDL2创建的窗口仅在调度中心可见问题求助

问题分析 #

在M1芯片的MacOS Sonoma系统中使用SDL2创建窗口时，窗口仅在打开Mission Control时可见、桌面无法正常显示，核心原因有两点：

• 误用SDL_CreateShapedWindow创建普通窗口，该函数默认用于异形窗口，在Sonoma系统下存在层级或渲染兼容性问题
• 渲染循环中未正确执行帧提交操作，导致窗口内容无法刷新到桌面

解决方案 #

1. 替换异形窗口创建函数为普通窗口函数 #

将SDL_CreateShapedWindow替换为SDL_CreateWindow，因为当前场景不需要异形窗口功能：

// 原代码
window = SDL_CreateShapedWindow(title, xpos, ypos, width, height, flags);
// 修改后
window = SDL_CreateWindow(title, xpos, ypos, width, height, flags);

2. 确保渲染循环执行帧提交 #

检查Game::render()函数，必须包含SDL_RenderPresent(renderer)来提交渲染内容到窗口，否则窗口无法正常显示：

void Game::render() {
    SDL_RenderClear(renderer);
    // 此处添加自定义绘制逻辑
    SDL_RenderPresent(renderer); // 必须调用此函数刷新窗口显示
}

3. 可选：添加高DPI兼容标志（针对M1 Mac） #

在窗口创建的flags中添加SDL_WINDOW_ALLOW_HIGHDPI，提升M1设备上的窗口显示兼容性：

const int flags = (fullscreen ? SDL_WINDOW_FULLSCREEN : SDL_WINDOW_SHOWN) | SDL_WINDOW_ALLOW_HIGHDPI;

4. 升级SDL2到最新版本 #

旧版本SDL2在M1 MacOS Sonoma上存在兼容性问题，建议升级到SDL2 2.28.0及以上版本。

修改后的完整窗口初始化代码示例 #

Game::Game(const char *title, int xpos, int ypos, int width, int height, bool fullscreen) {
    const int flags = (fullscreen ? SDL_WINDOW_FULLSCREEN : SDL_WINDOW_SHOWN) | SDL_WINDOW_ALLOW_HIGHDPI;

    if (SDL_Init(SDL_INIT_EVERYTHING) != 0) throw FailedSDLInitializationException();
    std::cout << "SDL Subsystem initialized." << std::endl;

    window = SDL_CreateWindow(title, xpos, ypos, width, height, flags);
    if (window == NULL) {
        SDL_Quit();
        throw FailedWindowInitializationException();
    }
    std::cout << "Window created." << std::endl;

    renderer = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
    if (renderer == NULL) {
        SDL_DestroyWindow(window);
        SDL_Quit();
        throw FailedRendererInitializationException();
    }
    SDL_SetRenderDrawColor(renderer, 255, 0, 255, 255);
    std::cout << "Renderer initialized." << std::endl;

    isRunning = true;
}

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