LVGLSharp:用 WinForms 风格 API 构建跨平台 LVGL 界面

介绍 LVGLSharp 的 WinForms 兼容层、运行时包、NativeAOT 和嵌入式 UI 价值。

LVGLSharp 是一个基于 LVGL 的跨平台 WinForms 风格 UI 技术栈。它的目标很明确:让开发者用接近 WinForms 的方式设计界面,并在 Windows、Linux、Headless、macOS、Remote 等不同运行时上运行。

为什么这件事重要

工业设备、边缘网关、HMI、测试仪表和嵌入式 Linux 终端经常需要图形界面。传统 WinForms 对桌面开发很友好,但不适合直接运行在 Linux framebuffer、Wayland、X11 或嵌入式环境里。LVGL 则适合嵌入式 UI,但 C API 和桌面设计器体验对 .NET 团队不够友好。

LVGLSharp 试图把两者连接起来:上层保留 WinForms 风格 API,下层用 LVGL 渲染。

当前能力

README 中列出的控件已经覆盖 Control、Form、Button、Label、TextBox、CheckBox、RadioButton、ComboBox、ListBox、PictureBox、Panel、GroupBox、FlowLayoutPanel、TableLayoutPanel、ProgressBar、TrackBar、NumericUpDown、RichTextBox 等常用组件。

底层互操作由 LVGLSharp.Interop 通过 ClangSharpPInvokeGenerator 自动生成 P/Invoke 绑定,必要时仍能直接访问 LVGL C API。

包和运行时

LVGLSharp 当前按 12 个包维护,包括主入口 LVGLSharp.Forms、共享抽象 LVGLSharp.Core、跨平台绘图类型 LVGLSharp.Drawing、底层绑定 LVGLSharp.Interop、多 RID 原生库 LVGLSharp.Native,以及 Windows、Linux、Headless、macOS、Remote、WPF、Analyzers 等包。

一般应用先引用 LVGLSharp.Forms,再按目标宿主选择运行时包。Windows 和 Linux 是当前稳定重点,Headless 可用于截图和回归测试。

NativeAOT 与设备部署

LVGLSharp 支持 NativeAOT 发布,并通过 LVGLSharp.Native 提供多 RID 原生库和发布时目标文件。对于嵌入式设备,这一点很重要:部署包需要尽量明确、可裁剪、可复制,不能依赖复杂桌面运行环境。

README 中也给出了多目标框架思路:Windows 侧保留 WinForms 设计器路径,net10.0 侧启用 UseLVGLSharpForms 和 PublishAot,再按目标 runtime 发布到 linux-arm64、linux-x64 或 Windows。

适合哪些场景

LVGLSharp 适合需要跨平台 UI 的工业设备:边缘网关本地屏、设备调试面板、嵌入式 HMI、产线终端、离线配置工具、测试台软件和需要 VNC/RDP 远程会话的设备界面。

它尤其适合已有 .NET / WinForms 经验的团队,因为上层 API 心智更接近桌面开发,而不是从头学习一套 C 风格嵌入式 UI。

当前边界

项目 README 明确提示仍在快速演进中,暂不建议直接用于生产环境。这是合理的边界声明。对准备试用的团队来说,更适合先从原型、内部工具、设备 UI 验证和自动化截图测试开始,再评估进入正式产品的节奏。

项目地址:IoTSharp/LVGLSharp

原文地址:https://iotpaper.net/articles/lvglsharp-winforms-lvgl-cross-platform/