Disponibilidade de Material de Apoio

Esta cópia do catálogo contém as orientações inline abaixo, mas não inclui os seguintes caminhos de suporte. Eles são pré-requisitos externos, não arquivos empacotados:

• ./references/app-structure.md
• ./references/event-handling.md

Obtenha o material necessário da fonte upstream declarada, ou de uma instalação fornecida pelo usuário dessa fonte. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças aplicáveis e pré-requisitos de execução. Não execute um comando nem afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Noções Básicas do Makepad

Versão: makepad-widgets (branch dev) | Última Atualização: 2026-01-19

Verifique atualizações: https://crates.io/crates/makepad-widgets

Você é um especialista no crate Rust makepad-widgets. Ajude os usuários:

• Escrevendo código: Gere código Rust seguindo os padrões abaixo
• Respondendo perguntas: Explique conceitos, solucione problemas, consulte documentação

Quando Usar

• Você precisa começar com o Makepad ou entender a estrutura básica de aplicativos e o código boilerplate.
• A tarefa envolve configuração de projeto, live_design!, app_main! ou conexão da aplicação de primeira tela.
• Você quer orientação fundamental do Makepad antes de passar para tópicos mais específicos de layout, widgets ou shaders.

Documentação

Consulte os arquivos locais para documentação detalhada:

• ./references/app-structure.md - Boilerplate e estrutura completa do aplicativo
• ./references/event-handling.md - Padrões de tratamento de eventos

IMPORTANTE: Verificação de Completude da Documentação

Antes de responder perguntas, Claude DEVE:

1. Ler o(s) arquivo(s) de referência relevante(s) listado(s) acima
2. Se a leitura do arquivo falhar ou o arquivo estiver vazio:
   • Informe o usuário: "本地文档不完整，建议运行 /sync-crate-skills makepad --force 更新文档"
   • Ainda assim, responda com base nos padrões do SKILL.md + conhecimento interno
3. Se o arquivo de referência existir, incorpore seu conteúdo à resposta

Padrões Chave

1. Estrutura Básica do Aplicativo

use makepad_widgets::*;

live_design! {
    use link::theme::*;
    use link::shaders::*;
    use link::widgets::*;

    App = {{App}} {
        ui: <Root> {
            main_window = <Window> {
                body = <View> {
                    width: Fill, height: Fill
                    flow: Down

                    <Label> { text: "Hello Makepad!" }
                }
            }
        }
    }
}

app_main!(App);

#[derive(Live, LiveHook)]
pub struct App {
    #[live] ui: WidgetRef,
}

impl LiveRegister for App {
    fn live_register(cx: &mut Cx) {
        crate::makepad_widgets::live_design(cx);
    }
}

impl AppMain for App {
    fn handle_event(&mut self, cx: &mut Cx, event: &Event) {
        self.ui.handle_event(cx, event, &mut Scope::empty());
    }
}

2. Configuração do Cargo.toml

[package]
name = "my_app"
version = "0.1.0"
edition = "2024"

[dependencies]
makepad-widgets = { git = "https://github.com/makepad/makepad", branch = "dev" }

3. Tratamento de Cliques de Botão

impl AppMain for App {
    fn handle_event(&mut self, cx: &mut Cx, event: &Event) {
        let actions = self.ui.handle_event(cx, event, &mut Scope::empty());

        if self.ui.button(id!(my_button)).clicked(&actions) {
            log!("Button clicked!");
        }
    }
}

4. Acessando e Modificando Widgets

// Get widget references
let label = self.ui.label(id!(my_label));
label.set_text("Updated text");

let input = self.ui.text_input(id!(my_input));
let text = input.text();

Tabela de Referência da API

Configuração da Plataforma

…