feat: 启用 host macOS SDL2 LVGL 适配包

启用 host macOS SDL2 LVGL 适配包。

Author: baotouyu

.github/workflows/host-macos-package.yml

@@ -11,6 +11,9 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Install SDL2
+        run: brew install sdl2
+
       - name: Build LVGL package
         run: ./scripts/build_host_macos.sh
 

.gitignore

@@ -1,5 +1,6 @@
 build/
 downloads/
 src/lvgl/
+.worktrees/
 *.tmp
 .DS_Store

CMakeLists.txt

@@ -13,10 +13,28 @@ if(NOT EXISTS "${LVGL_CONFIG_DIR}/lv_conf.h")
   message(FATAL_ERROR "lv_conf.h not found at ${LVGL_CONFIG_DIR}/lv_conf.h")
 endif()
 
+find_program(SDL2_CONFIG_EXECUTABLE sdl2-config REQUIRED)
+
+execute_process(COMMAND ${SDL2_CONFIG_EXECUTABLE} --cflags
+  OUTPUT_VARIABLE SDL2_CFLAGS
+  OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+
+execute_process(COMMAND ${SDL2_CONFIG_EXECUTABLE} --prefix
+  OUTPUT_VARIABLE SDL2_PREFIX
+  OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+
+separate_arguments(SDL2_CFLAGS_LIST NATIVE_COMMAND "${SDL2_CFLAGS}")
+set(SDL2_INCLUDE_DIR "${SDL2_PREFIX}/include")
+
 set(BUILD_SHARED_LIBS OFF CACHE BOOL "" FORCE)
 set(LV_CONF_PATH "${LVGL_CONFIG_DIR}/lv_conf.h" CACHE STRING "" FORCE)
 set(LV_CONF_BUILD_DISABLE_EXAMPLES ON CACHE BOOL "" FORCE)
 set(LV_CONF_BUILD_DISABLE_DEMOS ON CACHE BOOL "" FORCE)
 set(LV_CONF_BUILD_DISABLE_THORVG_INTERNAL ON CACHE BOOL "" FORCE)
 
 add_subdirectory("${LVGL_SOURCE_DIR}" "${CMAKE_BINARY_DIR}/lvgl")
+
+target_include_directories(lvgl PRIVATE "${SDL2_INCLUDE_DIR}")
+target_compile_options(lvgl PRIVATE ${SDL2_CFLAGS_LIST})

README.md

@@ -1,19 +1,19 @@
 # lvgl-prebuilt-host-macos
 
-这个仓库负责为 Mac host 产出 LVGL 9.1 预编译包。
+这个仓库负责为 Mac host 产出已适配 SDL2 的 LVGL 9.1 预编译包。
 
 它的职责是：
 
 - 固定 LVGL 官方版本。
 - 使用 Mac 工具链编译 `liblvgl.a`。
+- 启用 host macOS SDL2 display/input backend。
 - 导出成 `embedded-platform-core` 可以消费的包结构。
 
 它不负责：
 
 - 编译匠芯创 Luban-Lite 的 LVGL。
 - 编译全志 Linux 的 LVGL。
 - 封装 LVGL 控件 API。
-- 提供显示窗口、输入设备或平台 port。
 
 ## 产物结构
 
@@ -34,6 +34,12 @@ dist/lvgl/host_macos/
 
 `include/`、`lv_conf.h`、`lib/liblvgl.a` 必须成套使用，不能和其他平台的 LVGL 包混用。
 
+## 依赖
+
+```bash
+brew install sdl2
+```
+
 ## 构建
 
 ```bash
@@ -46,8 +52,16 @@ dist/lvgl/host_macos/
 ./scripts/verify_package.sh
 ```
 
+默认验证会编译 SDL2 demo，但不会强制打开窗口。需要本地看窗口效果时运行：
+
+```bash
+LVGL_RUN_SDL2_DEMO=1 ./scripts/verify_package.sh
+```
+
 ## 版本
 
 - LVGL tag: `v9.1.0`
 - LVGL commit: `e1c0b21b2723d391b885de4b2ee5cc997eccca91`
 - 平台: `host_macos`
+- 显示后端: `sdl2`
+- 输入后端: `sdl2`

config/host_macos/lv_conf.h

@@ -34,6 +34,16 @@
 #define LV_USE_PXP 0
 #define LV_USE_ROTATE_PXP 0
 #define LV_USE_DRAW_DAVE2D 0
+#define LV_USE_DRAW_SDL 0
+
+#define LV_USE_SDL 1
+#define LV_SDL_INCLUDE_PATH <SDL2/SDL.h>
+#define LV_SDL_RENDER_MODE LV_DISPLAY_RENDER_MODE_PARTIAL
+#define LV_SDL_BUF_COUNT 1
+#define LV_SDL_ACCELERATED 0
+#define LV_SDL_FULLSCREEN 0
+#define LV_SDL_DIRECT_EXIT 0
+#define LV_SDL_MOUSEWHEEL_MODE LV_SDL_MOUSEWHEEL_MODE_ENCODER
 
 #define LV_USE_LOG 0
 #define LV_USE_ASSERT_NULL 1

dist/lvgl/host_macos/include/lv_conf.h

@@ -34,6 +34,16 @@
 #define LV_USE_PXP 0
 #define LV_USE_ROTATE_PXP 0
 #define LV_USE_DRAW_DAVE2D 0
+#define LV_USE_DRAW_SDL 0
+
+#define LV_USE_SDL 1
+#define LV_SDL_INCLUDE_PATH <SDL2/SDL.h>
+#define LV_SDL_RENDER_MODE LV_DISPLAY_RENDER_MODE_PARTIAL
+#define LV_SDL_BUF_COUNT 1
+#define LV_SDL_ACCELERATED 0
+#define LV_SDL_FULLSCREEN 0
+#define LV_SDL_DIRECT_EXIT 0
+#define LV_SDL_MOUSEWHEEL_MODE LV_SDL_MOUSEWHEEL_MODE_ENCODER
 
 #define LV_USE_LOG 0
 #define LV_USE_ASSERT_NULL 1

dist/lvgl/host_macos/lib/liblvgl.a

@@ -2,7 +2,12 @@ lvgl.version=9.1.0
 lvgl.tag=v9.1.0
 lvgl.commit=e1c0b21b2723d391b885de4b2ee5cc997eccca91
 platform=host_macos
+display_backend=sdl2
+input_backend=sdl2
 toolchain=Apple clang version 21.0.0 (clang-2100.0.123.102)
 arch=arm64
-lv_conf_hash=75672b9ddbb6f51a26c8bef62d269d156eaffca988574cf9a205076f5fda9985
-lib_hash=f60379df5c6da0cd7341776f7d69facfa2b1bbbab2bad4fb027509ffa07ab8e2
+sdl2.version=2.32.10
+sdl2.cflags=-I/opt/homebrew/include/SDL2 -D_THREAD_SAFE
+sdl2.libs=-L/opt/homebrew/lib -lSDL2
+lv_conf_hash=c719a317f5b7e78ef074fffc7ef0d1f399f1e8bab38d000b4f950a14a6273dfb
+lib_hash=3758c0a3749cb31fe7275b36acd87533c7d24fcac850d429d5394e6eec01c469