anyuianyui
anyui-LIVE
anyui
反馈问题
  • English
  • 中文
anyui-LIVE
anyui
反馈问题
  • English
  • 中文
  • 介绍

    • 介绍
  • 快速开始

    • 快速开始
  • 工作区

    • 工作区
  • 编辑器

    • 概览
    • 工具栏
    • 导航器
    • 检查器
    • 事件流总览
    • 状态栏
    • 设置
    • 键盘快捷键
    • 画布
    • 预览
    • 资源管理
    • 代码查看器
    • 历史
  • 智能体
  • 桌面版
  • 主题

    • 图片
    • 字体库
    • 布局
    • 符号
    • 全局样式
    • 动态 LVGL 版本
    • 动态显示尺寸变更
    • 重置屏幕尺寸
    • 代码生成
    • 用户自定义代码
    • 移植
    • 模拟器
    • 国际化
  • 常见问题

导出工程的大部分内容由设计生成,手工修改这些生成文件并不能解决问题,需要回到编辑器改设计后重新生成。只有三处例外,它们就是留给你自己写代码的地方,而下一次导出对各自的保留规则并不相同。生成产物的整体结构见代码生成。

下面说的都是桌面应用把文件写入项目文件夹的情形;网页版每次下载的都是全新的 ZIP 压缩包,自己的改动需要手工合并回去。

代码写在哪里

位置写什么下一次导出如何处理
custom/custom_event.h、custom/custom_event.c调用函数事件动作要调用的函数。只补上设计新增调用所需的声明与空函数体,其余内容不动。
lv_conf.h项目设置管不到的固件特性,例如驱动、解码器、字体、日志与内存。只修正编辑器负责的那几个宏,并按设计中的资源需要打开对应开关。
main.c启动阶段的自定义代码,写在你需要它执行的时机。只修正传给 hal_init(...) 的显示尺寸;LVGL 8 连这一处也不会改动。

调用函数

调用函数是一种事件动作。在检查器的事件标签页中,为事件添加动作并选择调用函数,再填写要调用的函数名。函数名必须是合法的 C 标识符,生成代码会原样使用;生成的事件处理函数会把收到的事件对象作为参数传给你的函数:

handle_custom_click(event);

函数需要你自己实现,写在 custom/custom_event.c 中。导出时,工具会在 custom/custom_event.h 中加上声明,并在声明下方生成一个空函数体,前后各有一行标记注释。因此即使你还没有实现这个函数,工程也能编译通过:

/* anyui:preserve begin handle_custom_click */
void handle_custom_click(lv_event_t * event) {
    (void)event;
}
/* anyui:preserve end handle_custom_click */

函数体由你填写,之后的每次导出都会保留这段实现。合并只做追加:设计新增了哪些调用,就补上哪些函数,已有内容不会被重写、调整顺序或删除。anyui:preserve 标记注释是工具区分你的代码与它生成的骨架的依据,请勿删除。你在这两个文件中另外加入的内容,例如辅助函数或额外的 #include,同样原样保留。custom/ 目录与 generated/ 目录并列,并不嵌套在其中,生成前清理失效文件的那一步也不会涉及这里。

lv_conf.h

这份位于项目根目录的头文件决定固件的编译配置:显示与输入驱动、图片解码器、字体、日志级别、内存大小等。其中的开关由你决定,导出不会替换这份文件,只会修正归编辑器负责的那几行:

导出负责的值生效范围
色深所有目标版本。
显示宽度与高度仅 LVGL 8,LVGL 9 的尺寸写在 main.c 中。
原生像素格式仅 9.6.0,该版本的像素格式需与色深成对设置。
文件磁盘与图片解码器仅当设计用到时,规则见文件路径来源。

其余字节一律按文件现状保留,注释也不例外,即使用非 UTF-8 编码保存的头文件也不会因此被改写。在项目设置中修改分辨率或色深之后,下一次导出只更新对应的几个值,其他内容一概不动。

main.c

入口文件负责初始化 LVGL、初始化模拟器的显示,并加载第一个界面。设计中没有对应设置的启动代码,就按它需要执行的时机写在这里:开发板需要先准备时钟,就写在 lv_init() 之前;需要向 LVGL 登记的内容,就写在 lv_init() 之后、界面搭建之前;显示相关的准备,写在 hal_init(...) 调用的前后;界面启动时要读取的状态,写在 setup_ui() 之前。这份文件沿用了模拟器的常见分段注释——INCLUDES、DEFINES、TYPEDEFS、STATIC PROTOTYPES、GLOBAL FUNCTIONS,自己的声明与辅助函数放进对应段落即可。

这些改动都会被保留,因为导出在这份文件里只负责一个值:

  • LVGL 9 - 把 hal_init(...) 调用中的两个数字改成项目的分辨率。无论这个调用写在文件的哪个位置、带着什么参数,修正都能找到它,在 main() 中挪动位置或改用自定义参数都不受影响。若文件里既找不到这个调用,也没有可供插入的 lv_init(),导出会在结果中说明,而不会自行猜测插入位置。
  • LVGL 8 - 不作修改。该版本的尺寸取自 lv_conf.h,入口文件调用的是无参数的 hal_init(),因而完全保留你保存的样子。

如果这份文件明显属于另一个 LVGL 版本(例如你切换过目标版本),导出会放弃这次修正:保留你的文件,并在结果中说明原因,而不去修改一份当前目标版本无法编译的文件。

恢复编辑器生成的文件

正因为 lv_conf.h 与 main.c 只被修正、不被替换,项目文件夹里的文件仍可能与编辑器当前的生成结果不一致:头文件被其他工具改过,入口文件的 #include 与模拟器不再匹配。在桌面应用中,设置 → 项目 → 代码 面板的“构建文件”一行提供重新生成:工具会先把文件夹中的现有文件与将要写出的内容比对,再按项目当前设置写回生成的文件:

  • 内容已经一致的文件不做改动。
  • 只要文件里有你自己的改动,替换前就会在同目录保留一份带时间戳的 .bak 备份,你可以对照两份文件合并改动。
  • Makefile 同样会被重写,且不留备份;自己的构建扩展请写在 custom/custom.mk 中,生成的 Makefile 都会包含它。
  • 之后的首次构建会重新编译全部内容,因为文件夹中已有的目标文件是按刚刚替换掉的头文件编译的。

只有这一步会做备份。如果自己删除了其中某个文件,下一次导出只会重新生成一份,原有内容不再保留。

相关指南

  • 代码生成 - 生成器输出哪些文件,输出到哪里。
  • 移植 - 把生成代码接入目标工程。
  • 图片 - 需要 lv_conf.h 开启文件磁盘的文件路径来源。
  • 模拟器 - 按这些文件的配置构建并运行工程。
  • 事件流总览 - 查看调用这些函数的事件处理。
  • 设置 - “构建文件”一行所写入的导出文件夹。
Prev
代码生成
Next
移植