Merge pull request #10 from IoTSharp/9.5.0

9.5.0

Author: maikebing

.github/workflows/nuget-publish.yml

@@ -7,9 +7,9 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: "包版本号（如 9.3.0.5 或 v9.3.0.5）"
+        description: "包版本号（如 9.5.0.5 或 v9.5.0.5）"
         required: true
-        default: "9.3.0.5"
+        default: "9.5.0.5"
       publish_nuget:
         description: "发布到 NuGet.org"
         type: boolean
@@ -21,7 +21,7 @@ on:
 
 env:
   # 版本来源：优先使用 workflow_dispatch 输入，其次使用 tag 名称。
-  # 注意：tag/输入值可能含有 'v' 前缀（如 v9.3.0.5），会在 prepare 步骤中去除。
+  # 注意：tag/输入值可能含有 'v' 前缀（如 v9.5.0.5），会在 prepare 步骤中去除。
   PACKAGE_VERSION: ${{ github.event.inputs.version || github.ref_name }}
 
 jobs:
@@ -47,9 +47,9 @@ jobs:
           fi
 
           VERSION="${RAW_VERSION#v}"
-          # 按仓库当前 tag 约定，仅支持 4 段数字版本号，例如 9.3.0.5。
+          # 按仓库当前 tag 约定，仅支持 4 段数字版本号，例如 9.5.0.5。
           if [[ ! "$VERSION" =~ ^[0-9]+(\.[0-9]+){3}$ ]]; then
-            echo "错误：版本号 '$RAW_VERSION' 不符合要求，必须为四段版本号，如 v9.3.0.5 或 9.3.0.5。"
+            echo "错误：版本号 '$RAW_VERSION' 不符合要求，必须为四段版本号，如 v9.5.0.5 或 9.5.0.5。"
             exit 1
           fi
 
@@ -264,7 +264,7 @@ jobs:
       # ── 打包 LVGLSharp.Runtime.Windows（Windows 平台运行时） ───────────────
       - name: 打包 LVGLSharp.Runtime.Windows
         run: |
-          dotnet pack src/LVGLSharp.Windows/LVGLSharp.Runtime.Windows.csproj \
+          dotnet pack src/LVGLSharp.Runtime.Windows/LVGLSharp.Runtime.Windows.csproj \
             -c Release \
             -p:Version=${{ needs.prepare.outputs.package_version }} \
             --output nupkgs

.gitmodules

@@ -1,7 +1,3 @@
 [submodule "libs/lvgl"]
 	path = libs/lvgl
 	url = https://github.com/lvgl/lvgl.git
-[submodule "libs/lv_port_linux"]
-	path = libs/lv_port_linux
-	url = https://github.com/lvgl/lv_port_linux
-	branch = master

CHANGELOG.md

@@ -23,10 +23,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ---
 
-## [9.3.0.5] - 2026-03-17
+## [9.5.0.5] - 2026-03-23
 
 ### 发布说明 / Release Notes
-- 这是基于初始版本持续整理后的正式发布说明版本，用于统一对外描述当前阶段能力，并匹配 `v9.3.0.5` 发布 tag。
+- 这是切换到 LVGL `release/v9.5`、统一运行时命名并清理旧 X11 宿主辅助代码后的发布说明版本，用于匹配 `v9.5.0.5` 发布 tag。
 - 本版本重点在于沉淀已经完成的功能边界、运行时结构、包职责以及发布路径，便于后续按 tag 进行持续发布。
 
 ### 新增 / Added
@@ -42,18 +42,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ### 变更 / Changed
 - README 中补充当前发布版本、发布定位与自初始版本开始的发布记录入口说明。
-- 统一发布工作流示例版本、README 与 CHANGELOG 中的发布标识为 `9.3.0.5` / `v9.3.0.5`。
+- 统一发布工作流示例版本、README 与 CHANGELOG 中的发布标识为 `9.5.0.5` / `v9.5.0.5`。
 
 ### 修复 / Fixed
 - 无。
 
 ---
 
-## [9.3.0] - 初始版本 / Initial Release
+## [9.5.0] - 升级到 LVGL 9.5 / Upgrade to LVGL 9.5
 
 ### 新增 / Added
 - 项目初始化，基于 [imxcstar/LVGLSharp](https://github.com/imxcstar/LVGLSharp) 构建底层 LVGL .NET 封装。
-- 引入 LVGL 9.3 作为 git submodule。
+- 引入 LVGL 9.5 作为 git submodule。
 - 基础 `Control` 与 `Form` 类实现，支持 `Controls` 层级管理及 LVGL 对象创建。
 - 初步验证 NativeAOT 发布流程（win-x64、linux-arm）。
 

Directory.Build.props

@@ -12,7 +12,7 @@
     <PackageReadmeFile>README.md</PackageReadmeFile>
     <PackageTags>lvgl;embedded;ui;winforms;cross-platform</PackageTags>
     <!-- Default version; overridden by CI via -p:Version=... -->
-    <Version>9.3.0</Version>
+    <Version>9.5.0</Version>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(OS)' != 'Windows_NT'">

LVGLSharp.sln

@@ -9,7 +9,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Demos", "Demos", "{02EA681E
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SerialPort", "src\Demos\SerialPort\SerialPort.csproj", "{D371C54A-E3C9-40EB-BCBD-9FEDB246AE76}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LVGLSharp.Runtime.Windows", "src\LVGLSharp.Windows\LVGLSharp.Runtime.Windows.csproj", "{91F173AD-9AF0-F87F-FEF3-7E4742BABCB3}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LVGLSharp.Runtime.Windows", "src\LVGLSharp.Runtime.Windows\LVGLSharp.Runtime.Windows.csproj", "{91F173AD-9AF0-F87F-FEF3-7E4742BABCB3}"
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LVGLSharp.Runtime.Linux", "src\LVGLSharp.Runtime.Linux\LVGLSharp.Runtime.Linux.csproj", "{8836E179-4FC7-4EAD-AD1B-91BFA30DD3F7}"
 EndProject

README.md

@@ -10,11 +10,11 @@
 
 ## 📢 当前发布版本
 
-- **版本号**：`9.3.0.5`
-- **发布 Tag**：`v9.3.0.5`
+- **版本号**：`9.5.0.5`
+- **发布 Tag**：`v9.5.0.5`
 - **发布定位**：自初始版本演进而来的首个完整文档化发布，统一整理当前能力、包结构与发布说明。
 
-### 9.3.0.5 发布摘要
+### 9.5.0.5 发布摘要
 
 - 延续初始版本中基于 LVGL 的 WinForms API 兼容层方向，补齐核心控件、运行时宿主与打包说明。
 - 明确 `LVGLSharp.Forms`、`LVGLSharp.Core`、平台运行时包与 `LVGLSharp.Native` 的职责划分。
@@ -158,7 +158,7 @@ src/
 │   ├── Drawing/            # 跨平台绘图类型（Size、Point、Color 等）
 │   └── Runtime/            # 公共运行时注册入口与共享胶水代码
 ├── LVGLSharp.Core/         # 公共核心库
-├── LVGLSharp.Windows/      # Windows 平台运行时
+├── LVGLSharp.Runtime.Windows/ # Windows 平台运行时
 ├── LVGLSharp.Runtime.Linux/# Linux 平台运行时
 ├── LVGLSharp.Interop/      # LVGL P/Invoke 自动生成绑定
 ├── LVGLSharp.Native/       # 各平台原生库

README_en.md

@@ -10,11 +10,11 @@
 
 ## 📢 Current Release
 
-- **Version**: `9.3.0.5`
-- **Release Tag**: `v9.3.0.5`
+- **Version**: `9.5.0.5`
+- **Release Tag**: `v9.5.0.5`
 - **Release Positioning**: the first fully documented release derived from the initial project baseline, consolidating the current capabilities, package layout, and release notes.
 
-### 9.3.0.5 Highlights
+### 9.5.0.5 Highlights
 
 - Continues the initial LVGL-backed WinForms compatibility direction and documents the now-available controls, runtime hosts, and packaging layout.
 - Clarifies the responsibilities of `LVGLSharp.Forms`, `LVGLSharp.Core`, the platform runtime packages, and `LVGLSharp.Native`.
@@ -140,7 +140,7 @@ src/
 ├── LVGLSharp.Interop/      # LVGL P/Invoke auto-generated bindings
 ├── LVGLSharp.Native/       # Platform-native libraries
 ├── LVGLSharp.Core/         # Shared core library
-├── LVGLSharp.Windows/      # Windows platform runtime
+├── LVGLSharp.Runtime.Windows/ # Windows platform runtime
 ├── LVGLSharp.Runtime.Linux/# Linux platform runtime
 └── Demos/
     ├── WinFormsDemo/       # Baseline WinForms / LVGLSharp.Forms comparison demo

ROADMAP.md

@@ -43,6 +43,21 @@
   - 作为下一步实施重点开始推进
   - 首版目标仍按“最小可交付版本”落地，优先满足独立窗口、基础渲染、基础输入与 demo 跑通
 
+### `LVGLSharp.Forms` 兼容层收尾事项
+
+- 键盘消息兼容链已完成第一阶段打通：
+  - `PreProcessControlMessage`
+  - `PreviewKeyDown`
+  - `ProcessKeyMessage`
+  - `ProcessDialogKey` 第一版
+- 后续仍需继续收尾：
+  - `ProcessCmdKey` 第一版（常用快捷键与命令键消费语义）
+  - `ProcessDialogKey` 增强（`Enter` / `Escape` / 默认按钮 / 取消按钮 / 更完整焦点导航）
+  - `Focus` / `Focused` / `ContainsFocus` / `SelectNextControl` 与 LVGL `group/focus` 模型正式对齐
+  - `TextBox` 与 `Control` 键盘处理职责继续收敛，减少重复消费
+  - `Paint` / `Invalidate` / `Refresh` / `OnPrint` 的 LVGL 兼容策略评估与分层实现
+  - `Message` / `KeyEventArgs` / `KeyPressEventArgs` / `PreviewKeyDownEventArgs` 继续向 WinForms 语义补齐
+
 当前环境探测由 `LinuxEnvironmentDetector` 负责，`LinuxView` 只负责路由。
 
 ### 已支持 Linux 宿主说明

libs/lv_conf.h

@@ -1,6 +1,6 @@
 /**
  * @file lv_conf.h
- * Configuration file for v9.3.0-dev
+ * Configuration file for v9.5.0
  */
 
 /*