Dateien mit Cloud Storage in Flutter herunterladen

Mit Cloud Storage for Firebase können Sie Dateien schnell und einfach aus einem von Firebase bereitgestellten und verwalteten Cloud Storage-Bucket herunterladen.

Referenz erstellen

Zum Herunterladen einer Datei müssen Sie zuerst eine Cloud Storage-Referenz erstellen. zu der Datei hinzu, die Sie herunterladen möchten.

Sie können eine Referenz erstellen, indem Sie untergeordnete Pfade an das Stammverzeichnis Ihres Cloud Storage-Bucket erstellen oder eine Referenz aus einem vorhandenen erstellen gs://- oder https://-URL, die auf ein Objekt in Cloud Storage verweist.

// Create a storage reference from our app
final storageRef = FirebaseStorage.instance.ref();

// Create a reference with an initial file path and name
final pathReference = storageRef.child("images/stars.jpg");

// Create a reference to a file from a Google Cloud Storage URI
final gsReference =
    FirebaseStorage.instance.refFromURL("gs://YOUR_BUCKET/images/stars.jpg");

// Create a reference from an HTTPS URL
// Note that in the URL, characters are URL escaped!
final httpsReference = FirebaseStorage.instance.refFromURL(
    "https://firebasestorage.googleapis.com/b/YOUR_BUCKET/o/images%20stars.jpg");

Dateien herunterladen

Sobald Sie eine Referenz haben, können Sie Dateien aus Cloud Storage herunterladen durch Aufrufen von getData() oder getStream(). Wenn Sie die Datei lieber mit einer anderen Bibliothek herunterladen möchten, können Sie mit getDownloadUrl() eine Download-URL abrufen.

In Arbeitsspeicher herunterladen

Laden Sie die Datei mit der Methode getData() auf eine UInt8List herunter. Dies ist die einfachste Methode zum Herunterladen einer Datei. Allerdings muss der gesamte Inhalt der Datei in den Arbeitsspeicher geladen werden. Wenn Sie eine Datei anfordern, die größer als der verfügbare Arbeitsspeicher Ihrer App ist, stürzt Ihre App ab. Zum Schutz vor Speicherproblemen getData(). eine maximale Menge von Byte zum Herunterladen benötigt. Legen Sie die maximale Größe auf einen Wert fest, den Ihre App verarbeiten kann, oder verwenden Sie eine andere Downloadmethode.

final islandRef = storageRef.child("images/island.jpg");

try {
  const oneMegabyte = 1024 * 1024;
  final Uint8List? data = await islandRef.getData(oneMegabyte);
  // Data for "images/island.jpg" is returned, use this as needed.
} on FirebaseException catch (e) {
  // Handle any errors.
}

In eine lokale Datei herunterladen

Mit der Methode writeToFile() wird eine Datei direkt auf ein lokales Gerät heruntergeladen. Verwenden Sie diese Option, wenn möchten Ihre Nutzer offline auf die Datei zugreifen oder sie in einem für eine andere App. writeToFile() gibt eine DownloadTask zurück, die du zum Verwalten verwenden kannst und den Status des Downloads überwachen.

final islandRef = storageRef.child("images/island.jpg");

final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/images/island.jpg";
final file = File(filePath);

final downloadTask = islandRef.writeToFile(file);
downloadTask.snapshotEvents.listen((taskSnapshot) {
  switch (taskSnapshot.state) {
    case TaskState.running:
      // TODO: Handle this case.
      break;
    case TaskState.paused:
      // TODO: Handle this case.
      break;
    case TaskState.success:
      // TODO: Handle this case.
      break;
    case TaskState.canceled:
      // TODO: Handle this case.
      break;
    case TaskState.error:
      // TODO: Handle this case.
      break;
  }
});

Daten per URL herunterladen

Wenn Sie bereits eine Download-Infrastruktur basierend auf URLs haben oder eine URL freigegeben haben, können Sie die Download-URL für eine Datei abrufen, indem Sie die Methode Methode getDownloadURL() in einer Cloud Storage-Referenz.

final imageUrl =
    await storageRef.child("users/me/profile.png").getDownloadURL();

Fehler behandeln

Fehler können aus verschiedenen Gründen beim Download auftreten, Datei nicht vorhanden oder der Nutzer hat keine Zugriffsberechtigung für die gewünschte Datei. Weitere Informationen zu Fehlern finden Sie unter Fehler beheben. der Dokumentation.

Vollständiges Beispiel

Im Folgenden finden Sie ein vollständiges Beispiel für einen Download mit Fehlerbehandlung:

final islandRef = storageRef.child("images/island.jpg");

final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/images/island.jpg";
final file = File(filePath);

final downloadTask = islandRef.writeToFile(file);
downloadTask.snapshotEvents.listen((taskSnapshot) {
  switch (taskSnapshot.state) {
    case TaskState.running:
      // TODO: Handle this case.
      break;
    case TaskState.paused:
      // TODO: Handle this case.
      break;
    case TaskState.success:
      // TODO: Handle this case.
      break;
    case TaskState.canceled:
      // TODO: Handle this case.
      break;
    case TaskState.error:
      // TODO: Handle this case.
      break;
  }
});

Sie können auch Metadaten für gespeicherte Dateien abrufen und aktualisieren. in Cloud Storage.