Flutter'da Cloud Storage ile dosya indirme

Bu sayfada, Cloud Storage paketinden dosya indirmek için Cloud Storage for Firebase SDK'nın nasıl kullanılacağı açıklanmaktadır.

Referans oluşturma

Bir dosyayı indirmek için önce indirmek istediğiniz dosyaya yönelik bir Cloud Storage referansı oluşturun.

Cloud Storage paketinizin köküne alt yollar ekleyerek bir referans oluşturabilir veya Cloud Storage'daki bir nesneye referans veren mevcut bir gs:// ya da https:// URL'sinden referans oluşturabilirsiniz.

// Create a storage reference from your 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");

Dosyaları indir

Referans oluşturduktan sonra getData() yöntemini çağırarak Cloud Storage'dan dosya indirebilirsiniz. Dosyayı başka bir kitaplıkla indirmeyi tercih ederseniz getDownloadUrl() ile indirme URL'si alabilirsiniz.

Belleğe indirme

Dosyayı getData() yöntemini kullanarak UInt8List konumuna indirin. Bu, dosya indirmenin en kolay yoludur ancak dosyanızın tüm içeriğini belleğe yüklemesi gerekir. Uygulamanızın kullanılabilir belleğinden daha büyük bir dosya isterseniz uygulamanız kilitlenir. Bellek sorunlarına karşı koruma sağlamak için getData(), indirilecek maksimum bayt miktarını alır. Maksimum boyutu, uygulamanızın işleyebileceğini bildiğiniz bir değere ayarlayın veya başka bir indirme yöntemi kullanın.

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.
}

Yerel bir dosyaya indirme

writeToFile() yöntemi, dosyayı doğrudan yerel bir cihaza indirir. Kullanıcılarınızın dosyaya çevrimdışıyken erişmesini veya dosyayı farklı bir uygulamada paylaşmasını istiyorsanız bu yöntemi kullanın. writeToFile(), indirme işleminizi yönetmek ve indirme durumunu izlemek için kullanabileceğiniz bir DownloadTask döndürür.

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

URL üzerinden veri indirme

URL'lere dayalı bir indirme altyapınız varsa veya yalnızca paylaşmak için bir URL istiyorsanız Cloud Storage referansında getDownloadURL() yöntemini çağırarak bir dosyanın indirme URL'sini alabilirsiniz.

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

Hata işleme

İndirme sırasında hata oluşmasının çeşitli nedenleri olabilir. Örneğin, dosya mevcut olmayabilir veya kullanıcının istenen dosyaya erişim izni olmayabilir. Hatalar hakkında daha fazla bilgi için Hataları işleme başlıklı makaleyi inceleyin.

Tam örnek

Hata işleme ile indirme işleminin tam örneği aşağıda gösterilmiştir:

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

Cloud Storage'da depolanan dosyaların meta verilerini alabilir ve güncelleyebilirsiniz.