flutter_file_dialog

Visão geral do pacote

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

Um pacote Flutter que fornece diálogos nativos de seleção e salvamento de arquivos para Android e iOS. Ele permite que os usuários selecionem arquivos do dispositivo ou salvem arquivos por meio de interfaces nativas do sistema, garantindo uma experiência consistente entre plataformas. O pacote se integra perfeitamente aos aplicativos Flutter, oferecendo APIs simples para acionar operações de arquivos sem a necessidade de interfaces personalizadas. Suporta tipos comuns de arquivos e respeita as permissões e restrições específicas de acesso a arquivos em cada plataforma.

Casos de uso

Selecionando arquivos do armazenamento do dispositivo
Salvando arquivos para o dispositivo
Integrando diálogos nativos de arquivos em aplicativos multiplataforma
Manipulação de entrada de arquivos em aplicativos de mídia ou documentos
Habilitar gerenciamento de arquivos orientado pelo usuário
Suporte a fluxos de trabalho de importação/exportação de arquivos

Principais recursos

Integração de diálogos nativos no Android e no iOS
API simples para seleção e salvamento de arquivos
Compatibilidade multiplataforma
Respeita as regras específicas de acesso a arquivos do sistema operacional
Configuração mínima necessária
Suporta tipos comuns de arquivos

Indicado para

Aplicativos que precisam de seleção ou salvamento de arquivos
Desenvolvedores direcionados para Android e iOS
Projetos que exigem interfaces de arquivos nativas
Aplicativos de gerenciamento de mídia ou documentos
Aplicativos com necessidades de manipulação de arquivos orientadas pelo usuário

Considerações

Requer permissões apropriadas da plataforma
Limitado a operações de seleção/salvar arquivos apenas
Sem suporte para plataformas web ou desktop
Depende do acesso ao sistema de arquivos nativo do sistema operacional
Pode exigir configuração adicional para tipos específicos de arquivos

README original

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

Dialogs for picking and saving files and for picking directories in Android and in iOS.

Features

Supports Android (API level 24 or later) and iOS (13.0 or later).
Modern plugin implementation based on Kotlin (Android) and Swift (iOS).
Pick image files and other documents.
Save a file to a selected location.
Pick a directory and save files to the picked directory without further dialogs.
iOS dialog types: document and image.
iOS source types: camera, photo library, saved photos album.
Allow user to edit the picked image in iOS.
Set file extension filter and mime types filter when picking a document.
Possibility to limit picking a file from the local device only (Android).

Examples

Pick an image file

  final params = OpenFileDialogParams(
    dialogType: OpenFileDialogType.image,
    sourceType: SourceType.photoLibrary,
  );
  final filePath = await FlutterFileDialog.pickFile(params: params);
  print(filePath);

Pick a document

  final params = OpenFileDialogParams(
    dialogType: OpenFileDialogType,
    sourceType: SourceType.photoLibrary,
  );
  final filePath = await FlutterFileDialog.pickFile(params: params);
  print(filePath);

Save a file

final params = SaveFileDialogParams(sourceFilePath: "path_of_file_to_save");
final filePath = await FlutterFileDialog.saveFile(params: params);
print(filePath);

Pick a directory and save a file to the picked directory

if (!await FlutterFileDialog.isPickDirectorySupported()) {
  print("Picking directory not supported");
  return;
}

final pickedDirectory = await FlutterFileDialog.pickDirectory();

if (pickedDirectory != null) {
  final filePath = await FlutterFileDialog.saveFileToDirectory(
    directory: pickedDirectory!,
    data: file.readAsBytesSync(),
    mimeType: "image/jpeg",
    fileName: "fileName.jpeg",
    replace: true,
  );
}

Optimize picked image file using flutter_image_utilities

Use the plugin flutter_image_utilities to optimize a picked image file.

  final params = OpenFileDialogParams(
    dialogType: OpenFileDialogType.image,
    sourceType: SourceType.photoLibrary,
  );
  final filePath = await FlutterFileDialog.pickFile(params: params);
  print(filePath);

  if (filePath != null) {
    final pickedFile = File(filePath)

    // optimize the image file
    final optimizedFile = await FlutterImageUtilities.saveAsJpeg(
      sourceFile: pickedFile,
      quality: 60,
      maxWidth: 1920,
      maxHeight: 1024,
    );
  }