LVGLStudio 教程

开发者必读

LVGLStudio 内置完整的 Clang 工具链，点「运行」即可一键编译并启动工程：工程目录下所有源文件会被编译为单一可执行文件，LVGL 的所有源码都已编译进运行时，调用任何 LVGL API 只需 #include <lvgl.h>。

整个工程就是一个标准的 C 语言项目。LVGL、模拟器、编译器、输入/输出设备、显存 buffer 等所有必备环境都已就绪：新建一个 .c 文件、写 int main() 就能运行，LVGL 初始化会自动完成，开发者调用 LVGL 绘图 API 即可在模拟器中看到画面。

工程配置

创建工程时可指定 LVGL 版本（如 8.4.1）和屏幕分辨率（默认 240×240），后续在工程设置页可随时修改，修改后需要重新编译。运行时分辨率可通过 lvs_width 和 lvs_height 全局变量读取：

#include <LVGLStudio.h>
#include <lvgl.h>

int main() {
  printf("Screen size: %u x %u\n", lvs_width, lvs_height);
}

Hello LVGL

下面是一个最简单的 LVGL 程序：居中创建一个按钮，按钮上显示文字：

#include <LVGLStudio.h>
#include <lvgl.h>

int main() {
  // 居中创建一个按钮
  lv_obj_t *btn = lv_btn_create(lv_scr_act());
  lv_obj_set_size(btn, 120, 50);
  lv_obj_align(btn, LV_ALIGN_CENTER, 0, 0);

  // 按钮上添加文字
  lv_obj_t *label = lv_label_create(btn);
  lv_label_set_text(label, "Hello");
  lv_obj_center(label);
}

代码一致性

运行时使用的是官方 LVGL，从源码原样编译而来，没有修改任何一行代码。模拟器中看到的效果就是真机上的效果，写好的代码可直接迁移到真机运行。

外部输入设备

运行时已加载触摸屏、键盘、编码器、按钮四种输入设备。在模拟器屏幕上方滑动鼠标即可触发事件，左键按下 + 弹起模拟点按事件，右侧实时显示输入设备的状态信息。

使用 LVGL 标准的事件监听 API 即可接收这些事件。

键盘和按钮目前尚未实现，将在后续版本中提供。

编码器使用鼠标滚轮触发，滚轮按下模拟编码器点击事件，也可在右侧的编码器 tab 手动触发。

调试日志

调试代码时，可以使用 printf 输出日志信息。printf 在软件内置的 LVGLStudio.h 头文件中已被重定向到运行时底部的控制台。

注意：LVGLStudio.h 不会自动引入，需要在源码里手动写 #include <LVGLStudio.h>，且必须放在最前面 include，否则重定向可能不生效；printf 仍走标准 stdio，输出到 stdout，不会出现在下面的控制台。

#include <LVGLStudio.h>
#include <lvgl.h>

int main() {
  printf("Hello LVGLStudio!\n");
  // ...你的 LVGL 代码
}

printf 输出的内容会显示在运行时窗口的下半部分（控制台区域）：

LVGL 官方 API 文档：https://docs.lvgl.io/

本软件为免费开放使用的项目。