试用 LVGL Pro,一套完整的工具包,助您高效构建、测试、分享和交付 UI!
LVGL
版本发布

LVGL v8.0 发布,带来 CSS 风格布局和强大的滚动功能

重大版本发布,包含 CSS Flexbox 和 Grid 布局、简化的滚动功能、改进的控件、增强的事件系统,以及全新架构,使 LVGL 更加强大和灵活。

加博尔·基什-瓦莫希加博尔·基什-瓦莫希6 分钟阅读

v8.0 带来了许多新功能,包括简化且更强大的滚动、受 CSS Flexbox 和 Grid 启发的新布局系统、简化和改进的控件、更强大的事件系统、可挂钩的绘图功能等等。

破坏性变更

v8 是一个重大更新,因此与 v7 不向后兼容。请参阅下方的迁移指南了解如何升级您的项目。

目录结构#

项目组织结构已经过精简,以提高可维护性:

  • 文件夹名称中移除了 lv_ 前缀
  • docs 文档已移至 lvgl 仓库
  • examples 示例已移至 lvgl 仓库
  • 创建了 src/extra 文件夹用于复杂控件:
    • 使 LVGL 核心更加精简
    • 为大量特定控件提供空间
    • 为社区贡献提供绝佳场所

控件变更#

多个控件已被整合和重新设计:

  • 移除 lv_cont - 布局功能已移至 lv_obj
  • 移除 lv_page - 滚动功能已移至 lv_obj
  • 移除 lv_objmask - 相同效果可以通过事件实现
  • 新增 lv_meter,作为 lv_linemeter 和 lv_gauge 的合并
  • 新增 lv_span 控件,模仿 HTML <span> 标签
  • 新增 lv_animimg 控件,用于简单的幻灯片动画
  • 以及许多其他细微的变更和改进

新的滚动系统#

滚动功能现在更加灵活,可在任何对象上使用:

  • 支持"弹性"滚动,当滚动超出边界时
  • 支持任何对象类型之间的滚动链接(不仅限于 lv_page)
  • 移除 lv_drag - 类似效果可以通过在 LV_EVENT_PRESSING 中设置位置来实现
  • 添加吸附支持
  • 添加吸附停止功能,最多滚动 1 个吸附点

新的布局系统#

LVGL 现在支持现代 CSS 风格的布局:

样式系统改进#

样式系统已经过优化和简化:

  • 状态保存在对象中,而不是样式属性中
  • 对象的大小和位置也可以在样式中设置

增强的事件系统#

事件现在更加灵活和强大:

  • 允许向一个对象添加多个事件
  • 可以为添加的事件附加 user_data 用户数据

驱动程序变更#

提示

v8 中显示器和输入设备驱动程序初始化已更改。迁移时请仔细查看这些变更。

  • lv_disp_drv_t、lv_indev_drv_t、lv_fs_drv_t 需要声明为 static
  • ...disp_buf... 已重命名为 draw_buf。参见初始化示例 这里
  • 如果设置了两个屏幕大小的缓冲区,则不进行部分更新
  • disp_drv->full_refresh = 1 始终使整个显示器重绘
  • 需要在 disp_drv 中设置 hor_res 和 ver_res
  • indev_read_cb 返回 void。要指示还有更多数据需要读取,请在 read_cb 中设置 data->continue_reading = 1

其他重要变更#

  • 从创建函数中移除复制参数
  • 简化了文件系统接口 API
  • 使用更通用的继承模型
  • 内置主题已重新设计
  • lv_obj_align 现在会保存对齐方式并自动重新对齐对象,但只能对齐到父对象
  • lv_obj_align_to 可以对齐到任何对象,但不保存对齐方式
  • lv_pct(x) 可用于以百分比设置大小和位置
  • 控件中还有许多其他变更,此处未详细说明。请参考控件文档。

新的发布策略#

我们将遵循 GitLab 流程的发布分支:

  • 次要版本预计每 3-4 个月发布一次
  • master 分支将始终包含最新的变更

从 v7 迁移到 v8#

警告

首先最重要的是,基于 lv_conf_template.h 创建一个新的 lv_conf.h。

要尝试新版本,建议使用模拟器项目并查看示例。

将您的项目迁移到 v8 时:

  1. 按照上述说明更新驱动程序
  2. 更新样式
  3. 更新事件
  4. 使用新的布局系统替代 lv_cont 功能
  5. 使用 lv_obj 替代 lv_page
  6. 其他部分主要是细微的重命名和重构。请参阅函数文档以获取描述。

有关详细的迁移说明,请参阅 v8 迁移指南。

关于作者

加博尔·基什-瓦莫希
加博尔·基什-瓦莫希

LVGL 创始人

LVGL 的创始人和首席开发者,这是一个被全球数百万设备使用的开源嵌入式图形库。

认识博客背后的作者们

了解那些分享 LVGL 知识的优秀作者们

查看作者

订阅我们的通讯 不错过任何关于 LVGL 的新闻。我们每月最多发送 2 封邮件。

LVGL

LVGL 是最受欢迎的免费开源嵌入式图形库,支持任何 MCU、MPU 和显示类型,助您构建精美的用户界面。

我们还提供 UI 设计、实现和咨询等服务。

© 2026 LVGL。保留所有权利。
YouTubeGitHubLinkedIn