示例

1. 介绍

Solution 的示例程序主要存放于 solution\examples\_app_demo\application 目录下，通过独立例程演示各类功能、控件和资源用法。拿到代码后，建议先阅读 _app_demo/readme.md，再进入具体目录查看源码。

1.1 示例内容与用途

• 核心作用：

  • 通过独立例程展示 LVGL 基础控件、LVSF 扩展控件、图片资源、动态资源、网络入口和设备数据入口的使用方法。

• 适用场景：

  • 帮助用户快速熟悉特定功能的开发流程；

  • 提供可直接参考的代码模板，降低自定义开发的学习成本；

  • 验证功能兼容性，确保控件或特性在不同场景下的稳定运行。

1.2 使用建议

1. 入门学习：按功能分类查阅例程，对照代码理解核心 API 的调用方式；

2. 确认真实调用：如果要学习某个控件的最小写法，源码里应能看到对应 lv_xxx_create()、lv_xxx_set_xxx() 调用；只标注为“布局/效果参考”的页面，不等同于该控件的最小 API 示例；

3. 二次开发：基于例程修改参数或扩展逻辑，快速适配实际产品需求；

4. 问题排查：当开发中遇到功能异常时，可参考对应例程验证基础逻辑是否正确，定位问题根源。

1.3 后续规划

目前示例库正在持续补充中，从而进一步覆盖实际开发中的高频需求。

2. 已有例程说明

例程目录	说明
_mainmenu	通过 SiFli GUI_APP_FRAMEWORK 和控件生成主菜单。
basic_widgets	LVGL 基础控件示例，包括按钮、滑条、圆弧、开关、进度条、输入框、图表、样式和动画。
lvsf_widgets	LVSF 扩展控件真实调用示例，适合学习 lv_arcimg_create、lv_arctext_create、lv_basechart_create、lv_imgarray_create、lv_mulroller_create、lv_sector_create、lv_timeline_create 等接口。
text_widgets	文本类控件示例，包括 lvsf_baselabel、lvsf_txtimg、lvsf_txtanim、lvsf_txtlite 的显示和动效入口。
media_widgets	图片和动效类布局/效果参考页。该页用于说明界面组织和运行时状态变化，真实 API 以对应头文件和 framework/gui_widget 下 demo 为准。
list_select_widgets	列表和选择类布局参考页。源码注释列出 lvsf_select、lvsf_multroller、lvsf_multslider、lvsf_multlist、lvsf_scrollbar 的最小 API 入口。
connectivity	WiFi 扫描/连接、BT 扫描/配对、4G/LTE 网络入口和 Ping 流程示例。WiFi/4G 只在对应宏打开时调用真实入口，Ping 必须等待 net_is_connected()；PAN 需要单独 profile 和网络适配，本页不冒充支持。
device_data	电池、电量、传感器、天气线程入口和动态数据显示示例。
jpg	JPG 图片显示示例。
svg	SVG 图片显示示例。
multlist	multlist 典型应用场景，包含水平/竖直列表、常规滑动列表和按页滑动方式。详细介绍参见
seq_img	使用 lv_img_set_src_seq 接口以及 lvsf_seq_frame 控件显示序列帧资源。
tileview	平铺页面示例，包括长按选择、上滑删除与添加操作。
dynamic_res	动态资源加载示例。
vglite	VGLite 图形加速相关示例。