导出工程的大部分内容由设计生成,手工修改这些生成文件并不能解决问题,需要回到编辑器改设计后重新生成。只有三处例外,它们就是留给你自己写代码的地方,而下一次导出对各自的保留规则并不相同。生成产物的整体结构见代码生成。
下面说的都是桌面应用把文件写入项目文件夹的情形;网页版每次下载的都是全新的 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都会包含它。- 之后的首次构建会重新编译全部内容,因为文件夹中已有的目标文件是按刚刚替换掉的头文件编译的。
只有这一步会做备份。如果自己删除了其中某个文件,下一次导出只会重新生成一份,原有内容不再保留。