Forge KUI / 3.61.7

开发文档

安装、布局、业务接入与部署。按任务找到代码和接口。

01

选择语言与 SDK

确认架构、版本与运行库。

02

启动第一个窗口

建工程、编译、运行与排错。

03

跟着项目学

布局、事件、脚本、列表与桌面应用。

开始使用

选择 SDK 和版本

C++、C、Go 和 Rust 的 Windows x64 包、版本与构建要求。

运行第一个 C++ 窗口

使用 Windows x64 SDK 和一个包外 CMake 工程完成接入。

使用 C ABI

用公开 handle 管理窗口和文档，按包内示例接入 Full Profile。

接入 Go SDK

Windows x64 Full Profile，使用 Go 1.22+ 和 SDK 自带构建脚本。

接入 Rust SDK

在 Windows x64 MSVC 工具链下使用 kui 与 kui-sys。

构建界面

CSS、字体与布局

使用能力查询按属性和值确认支持范围。

页面、图片、字体与资源路径

选择内嵌或文件加载方式，避免换个目录就丢资源。

桌面窗口与标题栏

原生窗口配置、自定义标题栏、窗口按钮与退出清理。

表单与组件

表单、按钮、输入、选择与弹出层由 KUI 组件与 DOM 行为共同组成。

Canvas、WebGL 与图像

Canvas2D 与 WebGL 通过 KUI 的图形与脚本接口工作；它们的可用上下文、方法和限制需要分别查询，不能从浏览器同名 API 推断完整行为。

键盘、输入法与无障碍

交互界面需要同时考虑键盘焦点、输入法、选择状态和可访问语义。

连接业务

DOM、事件与数据

DOM 用于查找和更新元素，事件按捕获、目标、冒泡路径派发。

Lua 脚本

Lua 是可选脚本能力，由 KUI_ENABLE_SCRIPTING 控制。

窗口、线程与生命周期

先初始化平台，再创建窗口、加载文档并运行事件循环。

HTTP、异步任务与资源

HttpClient 和各绑定的网络入口用于宿主数据访问。

专业扩展

扩展与媒体部署

DOM 元素扩展通过 kuiext_* C ABI 与宿主对接，媒体后端使用 kui_media_* 协议。

嵌入代码编辑器

kui_ext_editor 提供独立的代码编辑器元素。

PDF 阅读与导出

PDF 阅读器是 PDFium 驱动的 kui_ext_pdf 元素扩展，核心文档导出与 PDF 阅读器是不同入口。

独立 3D 扩展

kui_ext_3d 独立于 KUI 核心，通过纯 C ABI 对接，使用 Filament 与 Bullet 等后端。

音频、视频与 Lottie

audio/video 由 KUI 媒体适配层连接后端，kui_media_audio 与 kui_media_video 使用媒体协议，不注册新的 DOM 元素。

开发与交付

DevTools 与 MCP

目标应用必须启动 DevTools，主线程持续轮询命令。

MCP：调整 UI 与自动化测试

把运行中的 KUI 应用交给 Agent 检查、修改和测试。包含官网实拍场景、实际工具参数与验收条件。

使用 Agent 开发 KUI 界面

从有效模板生成代码，再用运行中的 KUI 应用检查布局、事件和视觉结果。

测试界面与业务

用模型测试、实际输入、DOM 断言和截图分别证明结果。

记录与分析性能

先在固定机器、窗口尺寸、字体和包版本下复现卡顿。

部署、CRT 与运行库

C++ SDK 的跨 DLL 公共 ABI 使用 STL。

应用与调试安全

DevTools 是高权限接口，可能读取 DOM、日志、网络和脚本数据。

常见故障排查

查找构建、运行库、页面、输入与调试连接问题的检查位置。

从 Web 界面迁移到 KUI

保留 HTML/CSS 的设计方式，拆出浏览器依赖和宿主业务。

从 HTML 到原生窗口

了解文档、帧更新与渲染边界，便于集成和排错。

查询具体接口

查找类型、方法、CSS 属性、Lua 与扩展入口。公开指南与接口索引分别保留使用说明和声明来源。

打开 API 与支持查询 →