用途:帮助用户入门 Makepad(Rust 的 makepad-widgets crate),理解基础应用结构与样板代码,适用于项目搭建、live_design!、app_main! 以及首屏应用接线等任务,也可作为进入布局、控件或着色器主题前的基础指引。
主要能力:生成符合模式的 Rust 代码;解释概念、排查问题、引用文档。核心模式包括:用 use makepad_widgets::*; 导入;用 live_design! 宏定义 UI;实现 LiveRegister 与 AppMain trait;用 id!() 宏引用控件;在 handle_event 中处理事件。示例涵盖基础应用结构、Cargo.toml 依赖配置(makepad-widgets 指向 GitHub dev 分支)、按钮点击处理,以及通过 self.ui.label(id!(my_label)) 等访问和修改控件。API 参考涉及 live_design!、app_main!、#[derive(Live)]、WidgetRef、Cx、id!()。
使用方式:文档要求先阅读 ./references/app-structure.md 与 ./references/event-handling.md 两个参考文件;若读取失败或为空,应提示“本地文档不完整,建议运行 /sync-crate-skills makepad --force 更新文档”,并仍基于 SKILL.md 模式与内置知识作答。平台要求:macOS、Windows 开箱即用;Linux 需 apt-get install clang libaudio-dev libpulse-dev libx11-dev libxcursor-dev;Web 需 cargo install wasm-pack。
限制:本目录副本未包含上述两个参考路径,属外部前置材料,需从上游来源或用户安装处获取,缺失时不得编造或执行依赖步骤。该技能仅适用于明确匹配其范围的任务,输出不能替代环境相关验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。Makepad 为 GPU 优先、基于着色器渲染,同一代码可跨 Android、iOS、Linux、macOS、Windows、Web 运行;建议参考 UI Zoo 示例探索控件。版本为 makepad-widgets(dev 分支),最后更新 2026-01-19。