开发环境使用 global.json 声明的 .NET SDK 10.0.402、C# 14，以及支持 .NET 10 的 Rider 或 Visual Studio 2026。项目脚本与生成的 IDE 工程使用相同语言能力。
Canvas 是独立 UI 插件：RML 文档、字体依赖、DOM 事件和世界空间网格由本插件负责。它不引用 Rendering2D，也不提供 Camera 或 GameView 渲染模型。只有安装了能接受世界内容的渲染模型，GameView 和 Player 才会显示 Canvas。
本仓库独立安装和构建，不在 Plugins/ 中引用 Rendering2D。Assets/~Samples/SampleScene.iscene 只包含默认 800 × 450 逻辑像素、8 × 4.5 世界单位的 Canvas 和按钮控制脚本；点击按钮会更新计数并切换文字的 RCSS 淡出效果。在同时安装 Canvas 与 Rendering2D 的 TestProject 中配置 Camera2D 和 Rendering2DSceneSystem 后进行可视测试。安装态样例可只读打开，修改时先使用 Import Sample。Canvas 单独安装时文档 API 仍可工作，但没有渲染模型，GameView 不出图。
dotnet run \
--project ../InnoEngine/entry/InnoEngine.Editor -- .Canvas 的 referenceWidth、referenceHeight 默认是 800 × 450，始终决定 RML 百分比布局尺寸。项目级 CanvasProjectSettings.logicalPixelsPerWorldUnit 默认是 100；局部平面因此为 8 × 4.5 世界单位，再由自身和父级 Transform 缩放、旋转和定位。相机决定投影和最终屏幕像素密度。Canvas 不存字体、材质、Pipeline、排序或独立密度字段；材质由插件内部管理，2D 排序由 Rendering2D 的 SortingGroup2D 决定。
字体在 RML 中用 @font-face 声明，正文通过 font-family、font-weight 和 font-size 选择字体族、字形和大小。font-family: none 不绘制文字。字体文件会成为文档的资产依赖，换文档时重建 UI Context，避免旧字体或字形残留。文档依然可以使用 Canvas.SetText、SetClass、SetAttribute、SetContent 更新 HUD，用 Canvas.Listen(handler) 订阅点击等 DOM 事件。渲染输出阶段只将 DOM 事件入 Core EventDispatcher 队列，Canvas 在下一次 GameBehavior.Update 中派发；回调因此处于运行场景、音频及脚本的会话作用域。监听由 Core EventHub 按优先级分发，返回的订阅 token 应在脚本销毁时释放。
Canvas 的 RML 根默认填满独立的 referenceWidth × referenceHeight 布局区域，无需给 body 手工设置宽高。RCSS 中 position: absolute; right: 10dp; bottom: 10dp 相对 Canvas 右下边界计算；left: 50%; top: 50%; transform: translate(-50%, -50%) 将元素自身居中。显式 CSS 根尺寸仍可覆盖默认值；密度只决定屏幕上的物理像素，百分比始终按布局范围计算。<style>、<link href="Styles.rcss"> 与 RCSS @import 可用于样式及资产依赖，语法能力以 RmlUi 支持的 CSS 子集为准。
Assets/Runtime/Rendering 将 UI 作为中立 IViewContentSource 发布；Rendering2D 收集后与精灵统一排序，在场景颜色阶段和后处理之前绘制。输入先按 View 与同一绘制顺序命中，再逆变换成 Canvas 局部 RML 坐标。默认直接绘制网格和字形图集，不为每个 Canvas 固定创建纹理。
dotnet test Tests/InnoEngine.Canvas.Tests/InnoEngine.Canvas.Tests.csproj -p:CanvasToolsTarget=windows-x64
dotnet run \
--project ../InnoEngine/entry/InnoEngine.Build -- \
plugin --tools-target windows-x64 --project . --output Builds/InnoEngine.Canvas.iplugin \
--display-name InnoEngine.CanvasmacOS ARM64 测试使用 -p:CanvasToolsTarget=macos-arm64，导出使用 --tools-target macos-arm64。Shader 工具通过引擎发行的正式工具链准备并在测试期间持有读取 lease；不从第三方源码目录寻找预置可执行文件。原生 Metal 编译用例在其他系统明确报告为跳过，其余适用用例继续运行。
测试工程通过引擎现有的源码输入声明指定 checkout，Shader fixture 复用 Inno.Testing.Source 读取该声明；SDK 的独立输出目录不会改变源码归属。
需要在命令行同时验证脚本并生成 IDE 工程时，执行 dotnet run --project ../InnoEngine/entry/InnoEngine.Build -- scripts --tools-target windows-x64 --project . --output Builds/Scripts --ide；macOS 将工具目标改为 macos-arm64。
构建目录、Library/、Logs/ 和根目录生成的 IDE 工程都是派生文件。具体模块边界见 架构文档。