LVGLStudio
LVGLStudio 是一个面向 LVGL 开发者的桌面可视化开发工具,让你在电脑上编写 C 代码、即时在 PC 模拟器中查看运行效果,所见即所得,无需反复烧录到硬件。

LVGL 是一款流行的嵌入式图形库(GUI),广泛用于单片机、IoT 设备的屏幕交互界面开发。
软件优势
- 自带 Clang 编译器:内置完整的 C 编译环境,无需安装任何开发工具,下载即用
- 所见即所得:自带 PC 模拟器,编写代码后一键运行,实时看到 GUI 渲染效果
- 内置代码编辑器:基于 Monaco 的专业级编辑器,语法高亮、自动补全
- 多 LVGL 版本支持:内置多个 LVGL 版本可选,兼容你的目标版本
- 多分辨率支持:模拟器分辨率可自由配置(默认 240×240),快速验证不同屏幕尺寸下的布局
- 内置官方示例:创建工程时可一键勾选演示代码(基于 LVGL 官方 widget demo),零成本上手
- 跨平台:原生支持 macOS 与 Windows

快速开始
1. 新建工程
在主界面点击「新建工程」,填写工程名称。如果想快速看到效果,可以在「演示代码」下拉中选择一个示例模板(基于 LVGL 官方 widget demo),它会自动生成可运行的 main.c。

2. 调整工程设置(可选)
工程创建后默认带 LVGL 版本和屏幕分辨率。如果你需要调整,可以在「设置」tab 修改 LVGL 版本和屏幕宽高。代码中可通过 LV_HOR_RES / LV_VER_RES 宏拿到这两个值。

3. 配置编译宏(可选)
如果你的代码依赖 -D 宏定义(如 #if MY_MACRO),可以在「编译」tab 中按 key=value 格式一行一个地声明预定义宏。

4. 编辑源码
左侧菜单切到「代码」,在右侧 Monaco 编辑器里修改 main.c。比如示例工程生成的代码会调用 LVGL 官方的 widget demo:

5. 运行查看效果
点击左下角「▶ 运行」按钮,工具会自动编译你的代码并在 PC 模拟器中渲染。右侧可以切换 鼠标 / 键盘 / 按钮 / 编码器 来模拟不同的输入设备,底部会输出编译日志和 printf 内容。

常见问题
macOS 提示”无法打开 LVGLStudio,因为无法验证开发者”
LVGLStudio 是免费开放使用的项目,没有购买 Apple 开发者签名,所以第一次双击 .app 时 macOS 的 Gatekeeper 会拦截,弹出类似下面的提示:

解决方法:点击弹窗里的 取消 按钮(不要点「移到废纸篓」)。然后打开 系统设置 → 隐私与安全性,滚到最下面,会看到「仍要使用”LVGLStudio”,因为来自身份不明的开发者」一行,点击右侧的 仍要打开 按钮。

备选方法:也可以在 LVGLStudio.app 上右键 → 选择「打开方式」→「打开」,在弹出的确认框中点击「打开」按钮。

之后系统会再次弹窗确认,选择「打开」即可。以后再启动 LVGLStudio 就不会再拦截了。
加入官方交流群
如有疑问或反馈,欢迎加入官方 QQ 群:493643707
