面向 Framework 贡献者

开发 Playground

仓库内的 Rust 应用与 Framework 集成示例。

实验性源码版本。生产安全加固与 SDK 发布仍在进行中。

从外层克隆开始#

Playground 位于 src/tuffite/playground，通过 Cargo path 依赖使用相邻 SDK。开发命令构建并打包本地 Framework 源码、刷新原生应用，并以 Vite HMR 启动 Web 前端。

shell

mise run setup
mise run dev

检查类型化命令#

shell_api.d.ts 声明 playground 命名空间。生成门面提供 window.playground.commands.doSomething(message)、checkUtilitySession() 和 checkJavascriptExtension()。修改声明时同步更新 Rust/JavaScript 生成绑定。

shell

mise run tuff -- check playground/tuffite.json
mise run tuff -- generate playground/tuffite.json --check

开发原生运行时#

使用 Playground 验证原生修改、Explorer 集成、utility 会话和生成的 ShellAPI 绑定。Framework 构建提供明确的本地 Distribution；需要独立应用示例时打包 Playground。

shell

mise run framework -- test --suite framework
mise run framework -- test --suite smoke
mise run tuff -- package --manifest playground/tuffite.json