Files

T

cool 6287513794 feat: 添加 Linux 预览后端和 Notes 应用预览版本

- 创建 desktop_app_linux.h 作为跨平台后端抽象层
- 创建 notes_preview.c 使用 5x7 位图字体渲染
- 添加 Makefile.linux
构建脚本
- 添加 README_LINUX_PREVIEW.md 使用说明- 修复键盘映射、字符渲染、文本输入显示等问题

2026-08-05 13:15:46 +08:00

3.1 KiB

Raw Blame History

Deshab-OS 应用 Linux 预览功能

概述

允许在 Linux 开发机上预览 Deshab-OS 应用的 UI 效果。同一份 UI 绘制代码可以在 Linux 上通过 SDL2 后端预览，在 Deshab-OS 上通过 framebuffer 后端运行。

架构设计

┌────────────────────────────────────────────────────                          ─┐
│                  应用源代码 │
│  (使用 da_draw_char, da_fill_rect 等绘制函数)        │
└──────────────────┬──────────────────────────────────┘
                   │
        ┌──────────┴──────────┐
        │  #ifdef DA_LINUX_PREVIEW  │
        └──┬──────────────┬────────────┘
           │              │
            Linux 后端 Deshab-OS 后端
               
              (SDL2) (framebuffer) │              │
     X11/Wayland 窗口物理显示器

文件结构

CODE/tools/notes/
├── main.c              # Deshab-OS 原生应用入口
├──  Makefile            # Deshab-OS 编译用Makefile
├── notes_preview.c     # Linux 预览版（包含完整 dsk_entry 实现）
├── Makefile.linux      # Linux 编译用 Makefile
├── desktop_app_linux.h # Linux SDL2 后端
└── README_LINUX_PREVIEW.md  # 本说明文档

使用方法

1. 在 Linux 上编译预览版

cd CODE/tools/notes
make -f Makefile.linux

2. 运行预览版

./notes_preview

3. 退出预览

按 ESC 键关闭窗口。

4. 清理

make -f Makefile.linux clean

开发工作流


  1. 在 Linux 上编辑代码 ↓
2. make -f Makefile.linux 编译预览版
   ↓
3. ./notes_preview 查看 UI 效果
   ↓
4. 调试布局和渲染
   ↓
5. 测试通过后，用原生的 Makefile 编译到 Deshab-OS
   ↓
6. 在 Deshab-OS 中运行验证

支持的 UI 元素

元素	Linux 预览	Deshab-OS
背景填充	✅	✅
矩形填充	✅	✅
圆角矩形	✅	✅
ASCII 字符	✅	✅
字符串	✅	✅
标题栏	✅	✅
状态栏	✅	✅
鼠标光标	✅	✅
键盘输入	✅	✅
鼠标移动	✅	✅

扩展到其他应用

要为其他应用（如 fileman, editor, proedit）添加 Linux 预览支持：

复制 notes_preview.c 作为模板
修改 main() 中的 UI 逻辑
使用相同的 `desktop_app_linux.h

` 后端

依赖- SDL2 (`libsdl2-dev` on Debian/Ubuntu)

GCC 或 Clang
Make

注意事项

键盘映射：SDL2 的键盘扫描码需要映射到 Deshab的 PS/2 扫描码
鼠标行为：SDL2 鼠标事件转换为 Deshab 的鼠标数据包格式
字体数据：需要从 ascii_bitmaps.c 获取字模数据
性能：Linux 预览版主要用于 UI 调试，不是完整的功能测试

3.1 KiB Raw Blame History Unescape Escape