LitheView SDK 文档
LitheView 是面向原生产品的嵌入式 Web UI Runtime。它通过稳定的 C ABI 将现代 Web UI、同步与异步通信、GPU 渲染和离屏能力接入原生应用，并把完整运行时资源封装在单个 litheview.dll 中。
核心特性
| 特性 | 说明 |
|---|---|
| 单 DLL、极小体积交付 | 运行时资源全部内置，用更小的发布包带走完整 Web 能力 |
| 前沿 Web 特性 | 现代 JavaScript、WebGPU 与 CSS 能力随运行时持续演进 |
| 同步 / 异步通信 | 按场景使用同步调用、Promise 或结构化双向消息 |
| 原生窗口集成 | 衔接窗口、DPI、鼠标、键盘、光标、IME、文件拖拽和原生模态循环 |
| 完整调试能力 | 宿主显式开启后，可用外置 DevTools 前端检查 DOM、Console、Network 和实时元素高亮 |
| 真正的离屏渲染 | 无需可见窗口，持续交付可直接导入的共享 GPU 纹理帧 |
从这里开始
- 快速开始：配置 CMake、初始化 Runtime 并创建第一个 View。
- API Reference：按模块查看稳定接口和 Preview 能力。
- 最小宿主示例：完整了解生命周期与窗口绑定。
- JavaScript 双向通信：连接页面与原生业务逻辑。
- 错误码：处理参数、状态、线程和资源错误。
生命周期
- 在运行线程调用
ltv_initialize()。 - 调用
ltv_run()进入 LitheView 消息循环。 - 在 ready callback 中创建 View、绑定 HWND 并加载页面。
- 所有 View API 和回调继续在这条线程执行。
- 释放 GPU frame，停止 GPU output，并销毁全部 View。
- 调用
ltv_shutdown()；ltv_run()随后返回。
线程约束
所有生命周期函数、View API 和客户端回调都属于调用 ltv_run() 的线程。跨线程调用会返回 LTV_ERR_WRONG_THREAD。
SDK 组成
include/litheview/litheview.h C ABI
include/litheview/litheview.hpp 可选 C++ RAII 包装
include/litheview/litheview_win.h Windows 集成
lib/litheview.lib MSVC import library
bin/litheview.dll 运行时
lib/cmake/LitheView/ CMake package files
当前文档对应 LitheView 0.1.0、LTV_API_VERSION == 1。