Firebase için Cloud Storage, kullanıcı tarafından oluşturulan içerikleri (ör. resim ve video) yükleyip paylaşmanıza olanak tanır. Bu sayede uygulamalarınıza zengin medya içerikleri ekleyebilirsiniz. Verileriniz, yüksek kullanılabilirlik ve küresel yedekliliğe sahip, exabayt ölçeğinde bir nesne depolama çözümü olan Google Cloud Storage paketinde depolanır. Cloud Storage for Firebase, bu dosyaları doğrudan mobil cihazlardan ve web tarayıcılarından güvenli bir şekilde yüklemenize olanak tanır ve düzensiz ağları kolayca yönetir.
Başlamadan önce
Henüz yapmadıysanız Flutter uygulamaları için başlangıç kılavuzunu tamamladığınızdan emin olun. Bunlardan bazıları:
Firebase projesi oluşturma
Flutter için Firebase SDK'larını yükleme ve başlatma
Firebase projenizin kullandıkça öde Blaze fiyatlandırma planında olduğundan emin olun. Firebase ve Google Cloud'u yeni kullanmaya başladıysanız 300 ABD doları değerinde kredi almaya uygun olup olmadığınızı kontrol edin.
Varsayılan Cloud Storage paketi oluşturma
Firebase konsolunun gezinme bölmesinde Depolama'yı seçin.
Projeniz henüz kullandıkça öde Blaze fiyatlandırma planında değilse projenizi yükseltmeniz istenir.
Başlayın'ı tıklayın.
Varsayılan paketiniz için bir konum seçin.
,US-CENTRAL1
veUS-EAST1
bölgelerindeki bucket'lar, Google Cloud Storage için "Daima Ücretsiz" katmanından yararlanabilir. Diğer tüm konumlardaki paketler Google Cloud Storage fiyatlandırma ve kullanım koşullarına tabidir.US-WEST1
İsterseniz daha sonra her biri kendi konumuna sahip birden fazla paket oluşturabilirsiniz.
Varsayılan paketiniz için Firebase Security Rules özelliğini yapılandırın. Geliştirme sırasında kurallarınızı herkese açık erişime göre ayarlamayı düşünebilirsiniz.
Bitti'yi tıklayın.
Artık paketi Firebase konsolunun Cloud Storage Dosyalar sekmesinde görüntüleyebilirsiniz. Varsayılan paket adı biçiminiz PROJECT_ID.firebasestorage.app
Herkese açık erişimi ayarlama
Firebase için Cloud Storage, verilerinizin nasıl yapılandırılması, nasıl dizine eklenmesi ve ne zaman okunup yazılması gerektiğini tanımlamanıza olanak tanıyan bildirim temelli bir kural dili sağlar. Varsayılan olarak, Cloud Storage'a okuma ve yazma erişimi kısıtlanır. Bu nedenle, yalnızca kimliği doğrulanmış kullanıcılar veri okuyabilir veya yazabilir. Firebase Authentication'ı ayarlamadan başlamak için kurallarınızı herkese açık erişim için yapılandırabilirsiniz.
Bu işlem, Cloud Storage'ı uygulamanızı kullanmayan kişiler de dahil olmak üzere herkese açık hale getirir. Bu nedenle, kimlik doğrulamayı ayarladığınızda Cloud Storage'ınızı tekrar kısıtladığınızdan emin olun.
Cloud Storage SDK'sını uygulamanıza ekleme
Eklentiyi yüklemek için Flutter projenizin kökünden aşağıdaki komutu çalıştırın:
flutter pub add firebase_storage
İşlem tamamlandıktan sonra Flutter uygulamanızı yeniden oluşturun:
flutter run
Eklentiyi Dart kodunuza aktarın:
import 'package:firebase_storage/firebase_storage.dart';
Cloud Storage'ı ayarlayın
Flutter proje dizininizden
flutterfire configure
komutunu çalıştırın. Bu işlem, uygulamanızın kod tabanındaki Firebase yapılandırma dosyasını (firebase_options.dart
), varsayılan Cloud Storage paketin adını içerecek şekilde günceller.FirebaseStorage
örneği oluşturarak Cloud Storage paketinize erişin:final storage = FirebaseStorage.instance; // Alternatively, explicitly specify the bucket name URL. // final storage = FirebaseStorage.instanceFor(bucket: "gs://<var>BUCKET_NAME</var>");
Cloud Storage'ı kullanmaya başlayabilirsiniz.
Sonraki adım? Cloud Storage referansı oluşturma hakkında bilgi edinin.
Gelişmiş kurulum
Ek kurulum gerektiren birkaç kullanım alanı vardır:
- Birden fazla coğrafi bölgede Cloud Storage paketlerini kullanma
- Farklı depolama sınıflarındaki Cloud Storage paketlerini kullanma
- Aynı uygulamada birden fazla kimliği doğrulanmış kullanıcıyla Cloud Storage paketlerini kullanma
Dünyanın dört bir yanından kullanıcılarınız varsa ve verilerini onlara yakın bir yerde depolamak istiyorsanız ilk kullanım alanı idealdir. Örneğin, gecikmeyi azaltmak için bu bölgelerdeki kullanıcıların verilerini depolamak üzere ABD, Avrupa ve Asya'da paketler oluşturabilirsiniz.
İkinci kullanım alanı, farklı erişim kalıplarına sahip verileriniz varsa yararlıdır. Örneğin: Resimleri veya sık erişilen diğer içerikleri depolayan çok bölgeli ya da bölgesel bir paket ve kullanıcı yedeklerini veya seyrek erişilen diğer içerikleri depolayan nearline ya da coldline bir paket oluşturabilirsiniz.
Bu kullanım alanlarının her ikisinde de birden fazla Cloud Storage paketi kullanmak isteyeceksiniz.
Üçüncü kullanım alanı, Google Drive gibi kullanıcıların birden fazla hesapla oturum açmasına (örneğin, kişisel hesap ve iş hesabı) olanak tanıyan bir uygulama geliştiriyorsanız yararlıdır. Ek hesapların her birini kimlik doğrulamak için özel bir Firebase uygulaması örneği kullanabilirsiniz.
Birden fazla Cloud Storage paketi kullanma
Yukarıda belirtilen varsayılan Cloud Storage paketi dışında bir Cloud Storage paketi kullanmak veya tek bir uygulamada birden fazla Cloud Storage paketi kullanmak istiyorsanız özel paketinize referans veren bir FirebaseStorage
örneği oluşturabilirsiniz:
// Get a non-default Storage bucket
final storage = FirebaseStorage.instanceFor(bucket: "gs://my-custom-bucket");
İçe aktarılan paketlerle çalışma
Mevcut bir Cloud Storage paketini Firebase'e aktarırken Google Cloud SDK'da bulunan gsutil
aracını kullanarak Firebase'e bu dosyalara erişme izni vermeniz gerekir:
gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://YOUR-CLOUD-STORAGE-BUCKET
Proje numaranızı Firebase projelerine giriş bölümünde açıklandığı şekilde bulabilirsiniz.
Bu durum, varsayılan erişim denetimi Firebase'e izin verecek şekilde ayarlandığı için yeni oluşturulan paketleri etkilemez. Bu işlem geçici bir çözümdür ve gelecekte otomatik olarak yapılacaktır.
Özel bir Firebase uygulaması kullanma
Özel bir FirebaseApp
kullanarak daha karmaşık bir uygulama oluşturuyorsanız bu uygulamayla başlatılan bir FirebaseStorage
örneği oluşturabilirsiniz:
// Use a non-default App
final storage = FirebaseStorage.instanceFor(app: customApp);
Sonraki adımlar
- Uygulamanızı kullanıma sunmaya hazırlanma:
- Yalnızca uygulamalarınızın depolama alanı gruplarınıza erişebildiğinden emin olmak için Uygulama Kontrolü'nü etkinleştirin.
- Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.
- Projenizin birden fazla Firebase hizmetindeki kullanımına dair genel bir görünüm elde etmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin. Daha ayrıntılı kullanım bilgileri için Cloud Storage Kullanım kontrol panelini de ziyaret edebilirsiniz.
- Firebase lansman kontrol listesini inceleyin.