flutter_file_dialog

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter-Paket, das native Datei-Auswahl- und Speicherdialoge für Android und iOS bereitstellt. Es ermöglicht Benutzern, Dateien von ihrem Gerät auszuwählen oder über systeminterne Schnittstellen zu speichern, wodurch eine konsistente Erfahrung über Plattformen hinweg gewährleistet wird. Das Paket lässt sich nahtlos in Flutter-Anwendungen integrieren und bietet einfache APIs zum Auslösen von Dateioperationen, ohne benutzerdefinierte Benutzeroberflächen zu erfordern. Es unterstützt gängige Dateitypen und respektiert plattformspezifische Berechtigungen und Einschränkungen beim Dateizugriff.

Anwendungsfälle

Dateien aus dem Gerätespeicher auswählen
Dateien auf das Gerät speichern
Integration von nativen Dateidialogen in plattformübergreifende Anwendungen
Verarbeitung von Dateieingaben in Medien- oder Dokument-Apps
Benutzergetriebenes Dateimanagement aktivieren
Unterstützung von Datei-Import-/Export-Workflows

Hauptmerkmale

Native Dialogintegration für Android und iOS
Einfache API für Dateiauswahl und -speicherung
Plattformübergreifende Kompatibilität
Beachtet plattformspezifische Dateizugriffsregeln
Minimale Einrichtung erforderlich
Unterstützt gängige Dateitypen

Geeignet für

Apps, die Dateiauswahl oder -speicherung benötigen
Entwickler, die sowohl Android als auch iOS ansprechen
Projekte, die native Datei-UIs erfordern
Medien- oder Dokumentenverwaltungsanwendungen
Apps mit benutzergetriebener Dateiverwaltung

Hinweise

Erforderliche Plattformberechtigungen
Beschränkt auf Dateiauswahl/Speicheroperationen nur
Keine Unterstützung für Web- oder Desktop-Plattformen
Abhängig von der native OS-Dateisystem-Zugriff
Kann zusätzliche Konfiguration für bestimmte Dateitypen erfordern

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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,
    );
  }