3. 平台差异与抽象层

跨平台GUI框架的本质，是在多个差异巨大的原生平台之上，构建一层稳定、可移植的“契约”。这层契约既要屏蔽平台细节，又要保留平台能力。理解平台差异的来源，是设计抽象层的前提。差异主要集中在四个维度：操作系统API、窗口系统、输入事件模型、渲染管线。

一、四类平台差异的来源

操作系统API决定了进程、线程、文件、内存、时间、网络等基础能力。Windows以Win32为核心，macOS以POSIX加Cocoa/Foundation为主，Linux则依赖glibc与各类系统调用。同一语义在不同平台上的调用方式、错误码、线程模型都可能不同，例如线程本地存储、原子操作、高精度计时器的实现细节。

窗口系统是差异最显著的部分。Windows使用HWND与消息队列，macOS使用NSWindow与Cocoa事件循环，Linux上则有X11与Wayland两套体系。窗口的创建、显示、层级、装饰、多屏与DPI处理，各平台语义并不一致。Wayland甚至取消了全局坐标与全局窗口树，这对依赖绝对定位的框架是重大挑战。

输入事件模型差异体现在事件来源、分发路径与语义上。Windows通过消息循环投递WM_消息，macOS通过NSEvent与响应链，X11通过事件队列，Wayland通过seat与pointer/keyboard/touch资源。触摸、笔、滚轮、快捷键、输入法（IME）的组合方式各不相同，尤其是IME的候选窗口与提交时机，是跨平台输入处理的高频坑点。

渲染管线差异体现在图形API与合成方式上。Windows有GDI、Direct2D、Direct3D；macOS有Core Graphics、Metal；Linux有Cairo、OpenGL、Vulkan。GPU驱动、纹理格式、垂直同步、颜色空间、缩放策略都会影响最终呈现。框架需要决定是自绘、委托原生控件，还是混合渲染。

二、抽象层的设计原则

抽象层不是“把所有平台API包一层”，而是提炼出跨平台稳定的语义契约。以下五条原则在实践中反复被验证：

• 最小完备接口：接口只暴露上层真正需要的能力，避免把平台细节泄漏到框架层。接口越小，实现越容易保持一致。
• 能力查询而非假设：不要假设某平台一定支持某特性。应提供能力查询接口，例如是否支持多窗口、是否支持触摸、是否支持GPU合成，由上层按能力分支。
• 语义归一：把不同平台的事件、坐标、时间戳、修饰键统一成一套语义。例如把WM_MOUSEMOVE、NSEvent、X11 MotionNotify统一为PointerMove，并统一坐标系原点与DPI缩放。
• 可降级：当平台能力不足时，提供软件回退路径。例如GPU不可用时回退到CPU光栅化，Wayland不支持全局定位时回退到相对布局。
• 可旁路：允许上层在必要时直接访问原生句柄，用于集成平台特有功能，但必须显式、受控、可测试。

三、方法流程：从差异到契约

设计抽象层的推荐流程如下：

1. 盘点差异：列出目标平台在窗口、输入、渲染、系统服务上的具体差异，形成差异矩阵。
2. 定义语义：为每个能力定义跨平台统一的语义与数据结构，明确边界条件与错误语义。
3. 设计接口：以最小完备为原则设计接口，区分核心接口与可选扩展接口。
4. 实现后端：每个平台实现一个后端，后端之间不共享平台相关代码，只共享契约。
5. 验证一致性：用同一套测试用例跑所有后端，重点验证事件顺序、坐标、时间戳、生命周期。

四、案例：输入事件归一化

以鼠标移动事件为例，三个平台的原始数据差异明显：

Windows: WM_MOUSEMOVE  lParam = MAKELPARAM(x, y)   // 客户区坐标，整数
macOS:   NSEvent mouseLocation / locationInWindow  // 窗口坐标，原点左下
X11:     MotionNotify  event.x, event.y            // 窗口坐标，原点左上
Wayland: wl_pointer.motion  surface_x, surface_y   // 表面局部坐标，定点数

抽象层需要把它们统一为：

struct PointerMove {
  float x, y;          // 统一为左上原点、逻辑像素
  float dx, dy;        // 相对位移
  uint64_t timestamp;  // 统一为单调时钟，微秒
  Modifier mods;       // 统一修饰键位掩码
  PointerKind kind;    // Mouse / Touch / Pen
};

归一化过程中要处理：坐标原点翻转、DPI缩放、时间戳基准、修饰键映射、触摸与鼠标的语义区分。这些逻辑集中在PAL内，上层只消费PointerMove。

五、常见误区与复盘

误区	表现	后果	修正
抽象层过厚	把平台独有能力全部屏蔽	无法使用平台新特性	核心接口+扩展点
假设平台一致	默认所有平台支持多窗口/触摸	运行时崩溃或功能缺失	能力查询+降级
语义不归一	坐标、时间戳各平台不同	上层到处写条件分支	PAL内统一语义
忽略IME	输入法候选与提交时机不一致	中文输入错乱	统一IME事件模型
渲染后端耦合	上层直接调用D3D/Metal	移植成本高	渲染接口抽象

综上，平台差异是跨平台GUI的客观现实，抽象层是应对差异的工程手段。掌握操作系统API、窗口系统、输入事件、渲染管线四类差异，并遵循最小完备、能力查询、语义归一、可降级、可旁路五条原则，才能设计出既稳定又可扩展的抽象层。