LVGL-02 构建跨平台 GUI 开发框架：LVGL + CMake 工程实践指南

最新推荐文章于 2026-06-22 17:30:56 发布

原创

最新推荐文章于 2026-06-22 17:30:56 发布 · 668 阅读

标签

#LVGL #CMake #嵌入式Linux #跨平台开发

1. 环境准备与框架设计思路

在开始构建LVGL跨平台GUI开发框架之前，我们需要先理解一个核心问题：为什么选择LVGL + CMake的组合？我在实际项目中多次使用这个方案，最大的感受就是"一次配置，多处复用"。LVGL本身是一个轻量级且功能强大的图形库，而CMake作为构建工具，能够很好地管理跨平台编译的复杂性。两者结合，可以让你在嵌入式Linux、SDL桌面环境甚至RTOS上共享同一套代码基础，大大提升开发效率。

先来看看我们需要准备的基础环境。对于Linux开发环境，我推荐使用Ubuntu 20.04或22.04 LTS版本，这两个版本在长期支持性和软件包兼容性方面都表现不错。必备的依赖包包括CMake（3.15以上版本）、GCC编译器、SDL2开发库等。安装命令很简单：

sudo apt update
sudo apt install build-essential cmake libsdl2-dev

如果你使用的是其他Linux发行版，包管理器的命令会有所不同，但需要的软件包是类似的。这里有个小技巧：在开始之前，先运行cmake --version确认你的CMake版本符合要求。我曾经在一个旧系统上折腾了半天，最后发现是因为CMake版本太老导致各种奇怪的错误。

框架设计方面，我建议采用分层架构。最底层是LVGL官方源码，保持原样不动；中间层是SDK抽象层，负责生成统一的头文件和库文件；最上层是具体的应用程序。这样的设计有几个明显优势：当LVGL更新时，你只需要更新底层源码，不会影响上层的应用工程；SDK层提供了统一的接口，多个应用可以共享同一个LVGL库；编译依赖关系清晰，大大减少了头文件路径混乱的问题。

在实际项目中，我还发现一个有用的实践：为不同的目标平台创建不同的工具链文件。比如为嵌入式Linux创建arm-linux-gnueabihf.cmake，为桌面SDL环境创建x86_64-linux.cmake。这样在切换平台时，只需要指定不同的工具链文件，不需要修改核心的CMake配置。

2. LVGL SDK的构建与配置

构建LVGL SDK是整个框架中最关键的一步。很多开发者直接在自己的应用中引用LVGL源码，这样虽然简单，但随着项目规模扩大，会遇到各种依赖管理和版本控制的问题。通过构建独立的SDK层，我们可以实现更好的工程隔离和复用性。

首先创建SDK的目录结构。我习惯在workspace目录下创建lvgl_sdk文件夹，里面包含build、include和lib子目录。build用于存放编译中间文件，include将存放最终的头文件，lib则存放生成的库文件。这种结构清晰明了，也符合大多数开发者的习惯。

CMakeLists.txt的配置需要特别注意。以下是经过实际项目验证的完整配置：

cmake_minimum_required(VERSION 3.15)
project(lvgl_sdk C)

set(CMAKE_C_STANDARD 99)
set(CMAKE_C_STANDARD_REQUIRED ON)

# 设置输出目录
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/lib)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/lib)

# 指定LVGL源码路径
set(LVGL_SOURCE_DIR "${CMAKE_SOURCE_DIR}/../lvgl")
if(NOT EXISTS "${LVGL_SOURCE_DIR}/CMakeLists.txt")
    message(FATAL_ERROR "LVGL source not found at ${LVGL_SOURCE_DIR}")
endif()

# 设置lv_conf.h的路径
set(LV_CONF_DIR "${CMAKE_SOURCE_DIR}/include" CACHE PATH "Directory for lv_conf.h")

# 禁用示例和演示以减小库体积
set(CONFIG_LV_BUILD_EXAMPLES OFF CACHE BOOL "Build examples" FORCE)
set(CONFIG_LV_BUILD_DEMOS OFF CACHE BOOL "Build demos" FORCE)

# 包含LVGL子目录
add_subdirectory(${LVGL_SOURCE_DIR} ${CMAKE_BINARY_DIR}/lvgl_build)

# 设置库文件输出路径
set_target_properties(lvgl PROPERTIES
    ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/lib
    LIBRARY_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/lib
)

# 创建头文件目录并复制必要的头文件
file(MAKE_DIRECTORY ${CMAKE_SOURCE_DIR}/include/lvgl)
file(COPY ${LVGL_SOURCE_DIR}/src/
    DESTINATION ${CMAKE_SOURCE_DIR}/include/lvgl
    FILES_MATCHING PATTERN "*.h"
)

message(STATUS "SDK include prepared at ${CMAKE_SOURCE_DIR}/include")
message(STATUS "SDK lib output at ${CMAKE_SOURCE_DIR}/lib")

这个配置有几个关键点：首先设置了C99标准，这是LVGL的要求；其次明确指定了库文件输出目录，避免生成的库文件散落在各个角落；最重要的是处理头文件的方式——我们不是简单引用LVGL源码中的头文件，而是将其复制到SDK的include目录中，这样应用工程就不需要直接依赖LVGL源码了。

在构建SDK时，我建议先处理lv_conf.h配置文件。将lvgl目录下的lv_conf_template.h复制到lvgl_sdk/include目录，并重命名为lv_conf.h。然后根据你的需求修改这个文件，比如启用需要的功能、调整内存大小等。这个文件是LVGL的功能配置核心，好的配置可以在性能和功能之间取得最佳平衡。

完成配置后，使用标准的CMake构建流程：</