# lv_advanced

**Repository Path**: icanpool/lv_advanced

## Basic Information

- **Project Name**: lv_advanced
- **Description**: lvgl advanced components
- **Primary Language**: C
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2025-09-16
- **Last Updated**: 2026-02-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: LVGL, watch

## README

# 前言
lv_advanced 是基于 lvgl 开发的一套高级 UI 组件库，并支持 Qt 模拟器。

# 快速开始

## 下载代码
```bash
git clone --recursive https://gitee.com/icanpool/lv_advanced.git
```

## Qt 模拟器
### 依赖
- Qt 5.15+ (Windows + MSVC/MINGW)

### 运行
- 用 Qt Creator 打开 targets/simulator/qt/lv_advanced.pro 工程
- 编译、运行

![](./docs/images/simulator_qt.png)

- 修改 targets\simulator\qt\entry\lv_main.c 文件中 lv_adv_example_xx 可以体验其它 example
```c++
static void lv_adv_ctx_init(void)
{
    LV_LOG_USER("init");

    lv_adv_example_button_1();
}
```
- 文件 examples\lv_adv_examples.h 中包含所有可用 example

更多效果可以查看 [lv_advanced_doc](https://gitee.com/icanpool/lv_advanced_doc/blob/master/examples/examples.md)

### 换屏
模拟器默认是 466*466 的圆屏，如果目标屏幕是其它形状，可以通过下面方法改变屏幕的形状。

以立创·黄山派的 390*450 (四角弧半径 100) 为例，修改如下：

```c
// targets\simulator\qt\config.pri
DEFINES += LV_HOR_RES_MAX=390 LV_VER_RES_MAX=450 \

// targets\simulator\qt\entry\main.cpp
LvQtWindow w(false, 100);
```

![](./docs/images/simulator_qt_round.png)

## VS 模拟器
### 依赖
- Visual Studio 2022~（其它版本未测试）

### 运行
- 用 VS 打开 targets\simulator\vs 文件夹
- 编译、运行

![](./docs/images/simulator_vs.png)

- 修改 targets\simulator\vs\entry\main.cpp 文件中 lv_adv_example_xx 可以体验其它 example
```c++
    // lv_demo_widgets();
    // lv_demo_benchmark();

    lv_adv_example_button_1();
```

### 换屏
模拟器默认是 466*466 的圆屏，如果目标屏幕是其它形状，可以通过下面方法改变屏幕的形状。

以立创·黄山派的 390*450 (四角弧半径 100) 为例，修改如下：

```c
// targets\simulator\vs\entry\main.cpp
#define SIM_HOR_RES 390
#define SIM_VER_RES 450
#define SIM_SCREEN_RADIUS 100
```

![](./docs/images/simulator_vs_round.png)

## 嵌入式平台
### zephyr 模拟器

![](./docs/images/simulator_zephyr.png)

### zephyr @ apollo510

![](./docs/images/zephyr_apollo510.png)

### openvela 模拟器

![](./docs/images/simulator_openvela.png)

### rt-thread @ sf32lb52-lchspi

![](./docs/images/rt-thread_sf32lb52-lchspi.png)

# 规范
- 代码 git 提交格式：[git 知：提交格式](https://blog.csdn.net/canpool/article/details/126005367)
- 代码 style 规范 [.clang-format](./.clang-format)

# 贡献
- 欢迎提交 issue 对关心的问题发起讨论
- 欢迎 Fork 仓库，pull request 贡献

# 案例

## watchx

watchx 是基于 lv_advanced 开发的智能手表 UI 项目。

![](./docs/images/watchx.gif)


# 后语
加油，我们！