Wayland 源码解析之代码结构

 来源：http://blog.csdn.net/basilc/article/details/8074895

 

获取、编译 Wayland 及其依赖库可参考 Wayland 官方网站的 Build 指南：http://wayland.freedesktop.org/building.html。

Wayland 实现的代码组成可以分成以下四部分：

1.  Wayland 库

Wayland 中最核心的部分，Wayland 协议的大部分实现位于这里。

1）   工具程序（wayland-scanner）

分析 Wayland 协议文件，并生成相应的头文件及代码文件。

源码文件列表：

wayland/src/scanner.c

 

2）   工具库

供其他库、程序使用的工具函数、接口、结构等。

源码文件列表：

wayland/src/connection.c                           

wayland/src/wayland-util.c                         

wayland/src/wayland-util.h                         

wayland/src/wayland-os.c                           

wayland/src/wayland-os.h                           

wayland/src/wayland-private.h

 

3）   Client 库

供 Client 使用的桩接口（stub interfaces）及 event listener 结构定义。

源码文件列表：

wayland/src/wayland-protocol.c                     

wayland/src/wayland-client.c

 

4）   Server 库

Wayland 核心协议的实现。

源码文件列表：

wayland/src/wayland-protocol.c                     

wayland/src/wayland-server.c                       

wayland/src/wayland-shm.c                          

wayland/src/data-device.c                          

wayland/src/event-loop.c

 

5）   Cursor 库

Cursor 相关功能的实现。不作为重点分析部分。

源码文件列表：

wayland/cursor/wayland-cursor.h

wayland/cursor/wayland-cursor.c                       

wayland/cursor/os-compatibility.c                     

wayland/cursor/os-compatibility.h                     

wayland/cursor/xcursor.c                              

wayland/cursor/xcursor.h

 

6）   公用头文件

wayland/src/wayland-util.h

wayland/src/wayland-server-protocol.h

wayland/src/wayland-server.h  

wayland/src/wayland-client-protocol.h             

wayland/src/wayland-client.h         

wayland/src/wayland-version.h

wayland/src/wayland-egl.h

 

2.      EGL 相关实现

EGL surface 与 Waylandsurface 之间的互相转换，代码位于 mesa 中。

1）   libEGL 中的代码

mesa/src/egl/drivers/dri2/platform_wayland.c

mesa/src/egl/wayland/wayland-drm/wayland-drm.c

mesa/src/egl/wayland/wayland-drm/wayland-drm-protocol.c

mesa/src/egl/wayland/wayland-drm/wayland-drm-client-protocol.h

mesa/src/egl/wayland/wayland-drm/wayland-drm-server-protocol.h

 

2）   libwayland-egl

mesa/src/egl/wayland/wayland-egl/wayland-egl-priv.h

mesa/src/egl/wayland/wayland-egl/wayland-egl.c

 

3.      Weston （WaylandCompositor 的参考实现）

1）  Compositor

合成器的一个参考实现，代码较多，选取几个关键部分进行分析，如事件处理、图形输出等。

重点分析的源码列表：

weston/src/compositor.c

weston/src/compositor-drm.c

weston/src/evdev.c

 

2）  Shell （作为Compositor的插件实现）

可以认为是一个窗口管理器或桌面管理插件。

重点分析的源码列表：

weston/src/shell.c

 

3）  Clients

客户端程序，如 Terminal 等。不作为重点分析，仅在分析交互流程时，选取关键代码段进行分析。

 

4.      协议

一系列的 XML 文件，定义 Wayland的核心协议及扩展协议。

核心协议：

wayland/protocol/wayland.xml

mesa/src/egl/wayland/wayland-drm/wayland-drm.xml（很重要，可以认为是核心协议）

 

扩展协议（不作为重点分析对象）：

weston/protocol/desktop-shell.xml

weston/protocol/tablet-shell.xml

 

另外还有一些单元测试代码，位于 wayland 和weston 的tests 目录，主要用来测试通用的 utility 函数，查看这些代码对理解 utility 函数的用途是很有帮助的。