用途
Makepad Basics 是一个面向 Rust 的 makepad-widgets crate 的入门技能，用于帮助用户快速上手 Makepad 框架并理解其应用结构。它主要服务于两类场景：编写符合 Makepad 模式的 Rust 代码，以及解答概念问题、排查问题并引用相关文档。
主要能力
该技能覆盖 Makepad 入门所需的核心内容：
- 基础应用结构：提供完整的应用样板代码，包括 live_design! 宏、app_main! 宏、LiveRegister 与 AppMain trait 的实现方式。
- Cargo.toml 配置：给出依赖 makepad-widgets 的配置示例，使用 git 源与 dev 分支。
- 事件处理：展示通过 handle_event 方法处理事件、响应按钮点击的模式。
- 控件访问与修改：演示如何获取控件引用、设置文本、读取输入框内容。
- API 参考表：列出 live_design!、app_main!、#[derive(Live)]、WidgetRef、Cx、id!() 等宏与类型的说明及示例。
- 平台环境要求：说明 macOS、Windows、Linux、Web 各平台的前置条件。
使用方式
该技能以文档与代码模式的形式提供。在回答问题时，会先读取本地参考文件（./references/app-structure.md 与 ./references/event-handling.md），若文件读取失败或为空，则提示用户运行 /sync-crate-skills makepad --force 更新文档，并仍基于 SKILL.md 模式与内置知识作答。编写代码时遵循固定约定：始终包含 use makepad_widgets::*;、使用 live_design! 宏定义所有 UI、实现 LiveRegister 与 AppMain trait、使用 id!() 宏引用控件、通过 handle_event 方法处理事件。
适用场景
适合需要创建 Makepad 应用、定义 UI 结构、处理交互事件、访问和修改控件的开发者。也适合希望了解 Makepad 跨平台特性与 GPU 渲染理念的用户。文档建议通过 UI Zoo 示例探索控件。
限制
资料中未提供该技能的收费、价格、平台支持范围之外的具体效果或性能数据。版本信息为 makepad-widgets（dev 分支），最后更新于 2026-01-19，更新状态可通过 crates.io 页面查看。