LVGL logo LVGLSharp 跨平台 UI 文档
中文 EN

NuGet

安装指导、包选择与最小示例

这一页集中说明 LVGLSharp 当前 12 个包的职责、推荐组合和最小入口，方便你快速判断该引用哪些库。

查看源码仓库 阅读文档导航
  • LVGLSharp.Forms
  • Runtime.Windows
  • Runtime.Linux
  • Runtime.Headless
当前基线版本 9.5.0.5
包项目总数 12
NuGet 已发布 12
已入 pack 流水线 12
版本与下载量 实时徽章
发布组织 IoTSharp

12 个包

这些包共同构成当前仓库维护的正式包线。

LVGLSharp.Forms

主要的 WinForms 风格 API 兼容层，也是大多数应用接入时的入口包。

LVGLSharp.Core

共享运行时抽象、字体、诊断与公共辅助能力。

LVGLSharp.Interop

底层 LVGL P/Invoke 绑定，适合高级集成和低层控制。

LVGLSharp.Native

各平台对应的原生 LVGL 库与发布时目标文件。

LVGLSharp.Runtime.Windows

Windows 运行时宿主实现，适合桌面开发与验证。

LVGLSharp.Runtime.Linux

Linux 运行时宿主实现，覆盖 WSLg、X11、Wayland、SDL 与 FrameBuffer 路径。

LVGLSharp.Runtime.Headless

用于无头渲染、截图回归、自动化验证和远程帧源场景。

LVGLSharp.Runtime.MacOs

macOS 运行时包边界，当前提供诊断、上下文与宿主骨架。

LVGLSharp.Runtime.Remote

远程运行时抽象，覆盖会话、帧编码、输入事件与 VNC/RDP 方向。

补充包

这 3 个包同样属于正式包线，并已和其他包一起进入 NuGet 发布口径。

LVGLSharp.Drawing

跨平台绘图基础类型，避免直接依赖 System.Drawing。

LVGLSharp.WPF

实验性的 WPF 风格启动层与 XAML 运行时加载能力。

LVGLSharp.Analyzers

Roslyn 分析器，由 LVGLSharp.Forms 传递给应用项目。

按场景安装

如果你不想先理解全部包关系，可以直接按使用场景选择。

只跑 Windows

先装 LVGLSharp.Forms + LVGLSharp.Runtime.Windows。

 做跨平台验证

同时加上 Windows 和 Linux 运行时，方便多目标构建和宿主切换。

 做截图与自动化

加入 LVGLSharp.Runtime.Headless，用于 PNG 快照、测试与 CI 验证。

 做远程显示

需要远程会话、帧传输或 VNC/RDP 骨架时再加 LVGLSharp.Runtime.Remote。

推荐安装路径

如果你是第一次接入，建议按这个顺序走。

  1. 先添加 `LVGLSharp.Forms`
  2. 按目标平台添加 `LVGLSharp.Runtime.Windows` 或 `LVGLSharp.Runtime.Linux`
  3. 如果需要截图与自动化，再增加 `LVGLSharp.Runtime.Headless`
  4. 只有在明确探索远程或 macOS 路径时，再增加 `LVGLSharp.Runtime.Remote` 或 `LVGLSharp.Runtime.MacOs`
  5. 保持 `ApplicationConfiguration.Initialize()` 作为统一入口

12 个包概览

下表的版本与下载量统一由 NuGet 实时徽章显示。

包名 版本 下载量 状态 说明
LVGLSharp.Forms LVGLSharp.Forms NuGet NuGet 已发布 主应用入口包，提供 WinForms 风格 API 与运行时注册入口。
LVGLSharp.Core LVGLSharp.Core NuGet NuGet 已发布 共享运行时抽象、字体、诊断与宿主辅助能力。
LVGLSharp.Drawing LVGLSharp.Drawing NuGet NuGet 已发布 运行时与 UI 层共享的跨平台绘图基础类型。
LVGLSharp.Interop LVGLSharp.Interop NuGet NuGet 已发布 自动生成的 LVGL 底层 P/Invoke 绑定。
LVGLSharp.Native LVGLSharp.Native NuGet NuGet 已发布 多 RID 原生 LVGL 资产与发布时目标文件。
LVGLSharp.Runtime.Windows LVGLSharp.Runtime.Windows NuGet NuGet 已发布 Windows 桌面运行时与 Win32 宿主支持。
LVGLSharp.Runtime.Linux LVGLSharp.Runtime.Linux NuGet NuGet 已发布 Linux 运行时，覆盖 WSLg、X11、Wayland、SDL 与 FrameBuffer 路径。
LVGLSharp.Runtime.Headless LVGLSharp.Runtime.Headless NuGet NuGet 已发布 无头渲染、PNG 快照、回归验证与自动化运行时。
LVGLSharp.Runtime.MacOs LVGLSharp.Runtime.MacOs NuGet NuGet 已发布 早期 macOS 运行时包，已包含诊断与宿主骨架。
LVGLSharp.Runtime.Remote LVGLSharp.Runtime.Remote NuGet NuGet 已发布 远程会话抽象、帧传输与 VNC/RDP 相关运行时能力。
LVGLSharp.WPF LVGLSharp.WPF NuGet NuGet 已发布 基于 LVGLSharp.Forms 和 LVGLSharp.Runtime.Windows 的 WPF 风格启动与 XAML 运行时加载层。
LVGLSharp.Analyzers LVGLSharp.Analyzers NuGet NuGet 已发布 用于校验运行时包引用关系和仓库约束的 Roslyn 分析器。 
<PropertyGroup>
  <TargetFrameworks>net10.0-windows;net10.0</TargetFrameworks>
</PropertyGroup>

<PropertyGroup Condition="'$(TargetFramework)' == 'net10.0-windows'">
  <UseWindowsForms>true</UseWindowsForms>
</PropertyGroup>

<PropertyGroup Condition="'$(TargetFramework)' == 'net10.0'">
  <UseLVGLSharpForms>true</UseLVGLSharpForms>
  <PublishAot>true</PublishAot>
</PropertyGroup>

ApplicationConfiguration.Initialize();
Application.Run(new MainForm());