📚 课程目录第3章 EGL环境搭建

3. EGL环境搭建

在 OpenGL ES 的世界里，EGL 是连接原生窗口系统与图形 API 的“桥梁”。OpenGL ES 本身只负责渲染指令，它不知道窗口从哪里来、帧缓冲如何呈现到屏幕。EGL 负责创建渲染表面、管理上下文、协调双缓冲与交换，是 UI 渲染工程能否稳定运行的第一道关口。本章围绕 EGL 初始化、窗口表面创建、上下文管理、双缓冲与交换链机制，以及 Android/iOS 平台集成要点展开。

一、核心原理：EGL 在渲染管线中的位置

EGL 位于应用层与原生窗口系统之间，向上提供 OpenGL ES 所需的上下文与表面，向下对接 Android 的 ANativeWindow、iOS 的 CAEAGLLayer 或 Metal 纹理。一次完整的渲染链路通常包含四个对象：Display（显示连接）、Config（帧缓冲配置）、Surface（绘制目标）、Context（状态机）。它们的关系可以用下面的结构图表示。

图中可以看到，Display 是入口，Config 决定像素格式与缓冲能力，Surface 是绘制目标，Context 保存所有 GL 状态。四者缺一不可，且必须在同一线程内完成绑定与使用。

二、方法流程：从初始化到首帧上屏

标准 EGL 初始化流程可以拆成六步，每一步都有明确的失败点，工程中必须逐项检查返回值。

获取 Display：调用 eglGetDisplay(EGL_DEFAULT_DISPLAY)，Android 上通常返回默认显示连接。
初始化 EGL：调用 eglInitialize，获取主次版本号，确认驱动支持 GLES 2/3。
选择 Config：通过 eglChooseConfig 指定 RGBA、深度、模板、多重采样等属性，匹配最合适的帧缓冲配置。
创建 Context：调用 eglCreateContext，指定客户端版本与共享上下文，用于多线程资源共享。
创建 Surface：调用 eglCreateWindowSurface，绑定原生窗口句柄。
绑定并渲染：调用 eglMakeCurrent，随后执行 GL 绘制，最后 eglSwapBuffers 提交。

EGLDisplay display = eglGetDisplay(EGL_DEFAULT_DISPLAY);
eglInitialize(display, &major, &minor);

const EGLint configAttribs[] = {
    EGL_RENDERABLE_TYPE, EGL_OPENGL_ES3_BIT,
    EGL_SURFACE_TYPE,    EGL_WINDOW_BIT,
    EGL_RED_SIZE, 8, EGL_GREEN_SIZE, 8,
    EGL_BLUE_SIZE, 8, EGL_ALPHA_SIZE, 8,
    EGL_DEPTH_SIZE, 24, EGL_STENCIL_SIZE, 8,
    EGL_NONE
};
eglChooseConfig(display, configAttribs, &config, 1, &numConfigs);

EGLContext context = eglCreateContext(display, config,
                                      EGL_NO_CONTEXT, contextAttribs);
EGLSurface surface = eglCreateWindowSurface(display, config,
                                            nativeWindow, NULL);
eglMakeCurrent(display, surface, surface, context);
// ... OpenGL ES 绘制 ...
eglSwapBuffers(display, surface);

建议把 Display、Config、Context、Surface 封装成 EglCore 与 WindowSurface 两个类，避免在业务代码中散落 EGL 调用，也便于在 Surface 销毁重建时复用 Context。

三、双缓冲与交换链机制

EGL 默认使用双缓冲：前台缓冲用于显示，后台缓冲用于绘制。调用 eglSwapBuffers 时，驱动把后台缓冲交换到前台，同时把原前台缓冲回收为新的后台缓冲。这个过程受显示刷新率约束，若绘制速度超过刷新率，交换会阻塞，形成垂直同步；若绘制过慢，则出现掉帧。

在 Android 上，交换链由 BufferQueue 管理，通常包含 2～3 个缓冲。三缓冲可以在掉帧时提供额外缓冲，减少卡顿，但会增加一帧延迟。iOS 的 CAEAGLLayer 与 CAMetalLayer 也采用类似机制，presentRenderbuffer 或 presentDrawable 触发提交。理解交换链深度，是排查“画面撕裂”“输入延迟”“帧率不稳”的关键。

机制	缓冲数量	典型表现	适用场景
双缓冲	2	低延迟，可能掉帧	普通 UI、低功耗场景
三缓冲	3	更平滑，延迟略高	高帧率动画、复杂列表
单缓冲	1	易撕裂，不推荐	离屏渲染或测试

四、Android / iOS 平台集成要点

Android 侧：在 SurfaceView 或 TextureView 的 surfaceCreated 回调中创建 EGLSurface，在 surfaceDestroyed 中销毁并解绑。注意 SurfaceHolder 的尺寸变化会触发 Surface 重建，此时应保留 Context，仅重建 Surface。渲染线程建议独立于 UI 线程，避免阻塞主线程输入事件。

iOS 侧：使用 CAEAGLLayer 时需设置 drawableProperties 的 kEAGLDrawablePropertyRetainedBacking 为 false，并配置 kEAGLColorFormatRGBA8。若使用 Metal 后端，则通过 CAMetalLayer 与 nextDrawable 获取可绘制纹理，再桥接到 GLES 或直接使用 Metal。iOS 的 CADisplayLink 是驱动渲染循环的推荐方式，能精确对齐屏幕刷新。

常见误区：在 eglMakeCurrent 之前就调用 GL 函数，会导致上下文缺失而崩溃；在 Surface 销毁后继续调用 eglSwapBuffers，会返回 EGL_BAD_SURFACE。务必在生命周期回调中严格配对创建与销毁。

五、复盘与排障清单

初始化失败：检查 eglInitialize 返回值，确认设备支持所需 GLES 版本。
Config 不匹配：打印所有候选 Config，核对 RGBA、Depth、Stencil、MSAA 属性。
黑屏：确认 eglMakeCurrent 成功，且绘制后调用了 eglSwapBuffers。
卡顿：检查是否在 UI 线程做 GL 调用，或交换链深度不足导致等待。
资源泄漏：Context、Surface、Display 必须按创建逆序销毁，并调用 eglTerminate。

EGL 环境搭建是 UI 渲染工程的地基。只有把 Display、Config、Surface、Context 四者的生命周期管理清楚，把双缓冲与交换链的节奏控制好，后续的着色器、纹理、离屏渲染才能稳定运行。建议在项目初期就建立统一的 EGL 封装层，并在 Android 与 iOS 两端分别验证首帧上屏、后台恢复、尺寸变化三类场景。