跳到主要内容

LitheView 0.1.0

首个公开 SDK 版本。LTV_API_VERSION 和 LTV_STRUCT_VERSION 均为 1。

稳定能力​

  • Runtime 初始化、运行循环、版本查询和显式关闭。
  • View 创建、销毁、HTML/URL 加载、导航状态和页面信息。
  • 同步 JavaScript 表达式、异步 Promise 和 JSON Message Bridge。
  • View client 事件、popup、console、对话框、证书、文件选择和下载策略。
  • Windows HWND 绑定、DPI、鼠标、键盘、光标、IME、本地文件拖拽和原生模态循环。
  • 显式开关控制的 loopback DevTools 调试，可配合外置前端检查 DOM、Console、Network 和元素高亮。
  • CMake imported target LitheView::LitheView。

Preview 能力​

  • PNG 文件与内存截图。
  • 连续 GPU frame output。
  • LTV_GPU_DELIVERY_GPU_COPY 使用可共享 GPU 纹理，不经过 CPU readback。
  • LTV_GPU_DELIVERY_DIRECT 仅保留能力标识，本版本返回 LTV_ERR_UNSUPPORTED。

交付形式​

  • Windows x64。
  • 单个 litheview.dll 运行时。
  • Chromium Headless 资源、V8 startup snapshot 和 ICU 数据内置。
  • 不需要分发 headless_lib_*.pak、v8_context_snapshot.bin 或 icudtl.dat。

兼容性约定​

  • 公开 ABI 仅包括 ltv_* C 接口。
  • 版本化结构体使用 struct_size 和 version，字段只在尾部追加。
  • callback 数据默认借用，调用者拥有的数据统一由 ltv_free() 释放。
  • View 和 GPU frame 必须在 Runtime 关闭前显式释放。
  • 远程调试默认关闭；只有宿主设置 remote_debugging_enabled 和有效端口后才会打开。

已知限制​

  • 仅支持 Windows x64。
  • 所有 SDK API 和 callback 受单一 LitheView UI 线程约束。
  • GPU direct delivery 尚未实现。