Visão geral
O pacote SAF é um plugin do Flutter projetado para Android que se integra à API do Storage Access Framework (SAF), permitindo que os usuários acessem e gerenciem arquivos e pastas no armazenamento externo de forma segura. Ele simplifica operações com arquivos, como leitura, escrita e seleção de diretórios, por meio de uma interface padrão do sistema. Este plugin melhora o manuseio de arquivos em aplicativos que precisam acessar armazenamento compartilhado ou externo sem necessidade de permissões amplas. É especialmente útil para aplicações que precisam interagir com documentos, mídias ou arquivos gerenciados pelo usuário de maneira respeitosa com a privacidade.
Casos de uso
- Acessando armazenamento externo no Android
- Selecionando e gerenciando arquivos por meio do SAF
- Lendo e escrevendo arquivos em diretórios compartilhados
- Construindo aplicativos centrados em documentos
- Habilitar navegação de arquivos com a interface do sistema
- Apoio à conformidade com armazenamento escopo
Principais recursos
- integração SAF exclusiva para Android
- Acesso seguro a arquivos por meio de APIs do sistema
- Caixa de diálogo do seletor de arquivos integrada
- Suporta operações de leitura e escrita
- Compatível com armazenamento escopo
- Requisitos mínimos de permissão
Indicado para
- Aplicativos de gerenciamento de documentos
- Manipuladores de arquivos de mídia
- Ferramentas de backup de arquivos
- Aplicativos que exigem acesso a armazenamento externo
- Desenvolvedores direcionados ao armazenamento com escopo do Android
Considerações
- Limitado à plataforma Android
- Requer SDK do Android 21+
- Depende da disponibilidade do SAF de nível do sistema
- Pode exigir interação do usuário para seleção de arquivo
- Não adequado para plataformas iOS ou desktop