Disponibilidade de Material de Apoio

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

• ./references/platform-support.md

Solicite o material de apoio original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças e pré-requisitos de execução aplicáveis. Não execute um comando ou afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não crie 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.

Habilidade da Plataforma 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 em desenvolvimento multiplataforma Makepad. Ajude os usuários:

• Entendendo plataformas: Explique plataformas e backends suportados
• Código específico da plataforma: Ajude com compilação condicional e APIs de plataforma

Quando Usar

• Você precisa entender ou direcionar plataformas e backends gráficos específicos no Makepad.
• A tarefa envolve compatibilidade de plataforma, compilação condicional ou comportamento específico do sistema operacional em desktop, mobile ou web.
• Você precisa de orientação sobre diferenças de backend como Metal, D3D11, OpenGL, WebGL ou módulos de plataforma.

Documentação

Consulte os arquivos locais para documentação detalhada:

• ./references/platform-support.md - Detalhes da plataforma e OsType

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

Antes de responder às 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

Plataformas Suportadas

Enum OsType

pub enum OsType {
    Unknown,
    Windows,
    Macos,
    Linux { custom_window_chrome: bool },
    Ios,
    Android(AndroidParams),
    OpenHarmony,
    Web(WebParams),
    OpenXR,
}

// Check platform in code
fn handle_event(&mut self, cx: &mut Cx, event: &Event) {
    match cx.os_type() {
        OsType::Macos => { /* macOS-specific */ }
        OsType::Windows => { /* Windows-specific */ }
        OsType::Web(_) => { /* Web-specific */ }
        _ => {}
    }
}

Detecção de Plataforma

// In Cx
impl Cx {
    pub fn os_type(&self) -> OsType;
    pub fn gpu_info(&self) -> &GpuInfo;
    pub fn xr_capabilities(&self) -> &XrCapabilities;
    pub fn cpu_cores(&self) -> usize;
}

Compilação Condicional

// Compile-time platform detection
#[cfg(target_os = "macos")]
fn macos_only() { }

#[cfg(target_os = "windows")]
fn windows_only() { }

#[cfg(target_os = "linux")]
fn linux_only() { }

#[cfg(target_arch = "wasm32")]
fn web_only() { }

#[cfg(target_os = "android")]
fn android_only() { }

#[cfg(target_os = "ios")]
fn ios_only() { }

Recursos Específicos da Plataforma

Desktop (macOS/Windows/Linux)

• Gerenciamento de janelas (redimensionar, minimizar, maximizar)
• Caixas de diálogo de arquivos
• Menu do sistema
• Arrastar e soltar
• Múltiplos monitores

Mobile (iOS/Android)

• Entrada por toque
• Teclado virtual
• Orientação da tela
• Ciclo de vida do aplicativo (primeiro plano/segundo plano)

Web (WebGL2)

• Integração com DOM
• Eventos do navegador
• Armazenamento local
• Requisições HTTP

Ponto de Entrada

// Macro de entrada do aplicativo
app_main!(App);

pub struct App {
    ui: WidgetRef,
}

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

impl AppMain for App {

…