Integração Nativa

Acesso ao sistema de arquivos, notificações e APIs do SO a partir de aplicativos desktop Rust - padrões portáteis e ressalvas de plataforma.

Receita

fn app_data_dir() -> std::io::Result<std::path::PathBuf> {
    let base = dirs::data_local_dir().ok_or(std::io::ErrorKind::NotFound)?;
    Ok(base.join("com.example.myapp"))
}

Quando usar isso:

• Caixas de diálogo Abrir/Salvar e caminhos de arrastar e soltar
• Notificações do sistema para tarefas longas
• Autoinicialização, deep links e esquemas de URL personalizados
• Armazenamento seguro de credenciais no keychain do SO

Exemplo de Trabalho

fn ensure_data_dir() -> std::io::Result<std::path::PathBuf> {
    let dir = app_data_dir()?;
    std::fs::create_dir_all(&dir)?;
    Ok(dir)
}
 
fn app_data_dir() -> std::io::Result<std::path::PathBuf> {
    let base = dirs::data_local_dir().ok_or(std::io::ErrorKind::NotFound)?;
    Ok(base.join("com.example.myapp"))
}
 
fn pick_config_file() -> Option<std::path::PathBuf> {
    rfd::FileDialog::new()
        .add_filter("toml", &["toml"])
        .pick_file()
}

O que isso demonstra:

• Diretório de dados apropriado para a plataforma via dirs
• Configuração de diretório para criar na primeira execução
• Seletor de arquivos filtrado para importação de configuração

Mergulho Profundo

Como Funciona

• Tauri expõe APIs de FS com escopo por meio de permissões na configuração.
• rfd bloqueia brevemente para caixas de diálogo modais - chame a partir do thread da UI.
• notify-rust / plugin de notificação Tauri posta toasts do SO.
• Crate keyring abstrai macOS Keychain, Windows Credential Manager, Secret Service.

Exemplos de Capacidade

Armadilhas

• Caminhos /Users/... codificados - quebra Linux/Windows. Correção: sempre use dirs ou o resolvedor Tauri.
• Seguir links simbólicos para fora do sandbox - fuga de segurança. Correção: canonize e verifique o prefixo sob a raiz concedida.
• Caixa de diálogo fora do thread da UI no macOS - avisos de comportamento indefinido. Correção: apenas thread principal para caixas de diálogo modais.
• Permissão de notificação não solicitada (macOS) - falha silenciosa. Correção: solicite uma vez com uma explicação.
• Chaves de API em texto plano em config.toml - vazadas em backups. Correção: entrada de keychain por máquina do usuário.

Alternativas

FAQs

Relacionado

• Tauri - modelo de permissões
• Estado e Arquitetura - onde a configuração de caminhos reside
• Empacotamento e Distribuição - pacotes assinados
• Noções Básicas de GUI - exemplo de caixa de diálogo de arquivo

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4 e Polars 0.46+.