flutter_document_picker

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote Flutter que permite aos usuários selecionar documentos do sistema de arquivos do dispositivo. O documento selecionado é automaticamente copiado para o diretório temporário do aplicativo para acesso seguro. Ele suporta filtragem de arquivos por extensões específicas, melhorando a usabilidade para seleção direcionada de arquivos. Disponível para Android e iOS, integra-se perfeitamente aos seletores nativos de arquivos. Ideal para aplicativos que exigem upload ou importação de documentos sem acesso direto ao sistema de arquivos.

Casos de uso

Upload de documento em formulários
Importando arquivos gerados pelo usuário
Compartilhamento de arquivos entre aplicativos
Lendo arquivos de configuração externos
Suporte a fluxos de trabalho baseados em documentos

Principais recursos

Selecionar documentos com filtragem por extensão
Copia automaticamente arquivos para o diretório temporário
Plataforma cruzada (Android e iOS)
Integração simples da API
Gerenciamento seguro de arquivos temporários

Indicado para

Aplicativos que precisam de entrada de arquivo
Recursos de gerenciamento de documentos
Importação de arquivos orientada pelo usuário
Ferramentas de coleta de dados móveis
Acesso a arquivos centrado na privacidade

Considerações

Arquivos são copiados para armazenamento temporário
Limitado a tipos de arquivo suportados
Requer permissões específicas da plataforma
Arquivos temporários podem ser excluídos ao reiniciar o aplicativo
Acesso direto ao caminho do arquivo original não disponível

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Allows user pick a document. Picked document is copied to app temporary directory. Optionally allows pick document with specific extension only.

When file is picked its extension is checked using allowedFileExtensions parameter. Then file is copied to app temp directory. Copied file path is returned as result. If picked file extension is not in allowedFileExtensions list then extension_mismatch error is returned.

In Android Intent.ACTION_OPEN_DOCUMENT is used. This intent is supported only from Android 19 (KitKat) SDK version. So this plugin can be used only if app minSdkVersion is 19 or more.

In iOS UIDocumentPickerViewController is used. Files can be filtered by list of UTI types using allowedUtiTypes parameter. Picked file path is returned as result.

Params

Plugin has 3 optional parameters to help pick only specific document type:

List<String> allowedUtiTypes (used only in iOS)

In iOS Uniform Type Identifiers is used to check document types. If list is null or empty "public.data" document type will be provided. Only documents with provided UTI types will be enabled in iOS document picker.

More info: https://developer.apple.com/library/archive/qa/qa1587/_index.html
List<String> allowedFileExtensions (used both in iOS and in Android)

List of file extensions that picked file should have. If list is null or empty - picked document extension will not be checked.
List<String> allowedMimeTypes (used only in Android)

Only files with provided MIME types will be shown in document picker. If list is null or empty - */* MIME type will be used.
List<String> invalidFileNameSymbols (used both in iOS and in Android)

List symbols that will be sanitized to "_" in the selected document name. I.e. Google Drive allows symbol '/' in the document name, but this symbol is not allowed in file name that will be saved locally.

Default list: ['/'].

Example: file name 'Report_2018/12/08.txt' will be replaced to 'Report_2018_12_08.txt'

Example

//Without parameters:
final path = await FlutterDocumentPicker.openDocument();
  
  ...

    
//With parameters:
FlutterDocumentPickerParams params = FlutterDocumentPickerParams(      
  allowedFileExtensions: ['mwfbak'],
  allowedUtiTypes: ['com.sidlatau.example.mwfbak'],
  allowedMimeTypes: ['application/*'],
  invalidFileNameSymbols: ['/'],
);

final path = await FlutterDocumentPicker.openDocument(params: params);

//Pick multiple files:
final paths = await FlutterDocumentPicker.openDocuments(params: params);

Buscar pacotes, repositórios e categorias de apps