Cloud Storage for Firebase, kullanıcı tarafından oluşturulan içerikleri yüklemenize ve paylaşmanıza izin verir. Bu şekilde, reklamlarınıza zengin medya içeriği oluşturabilirsiniz. Böylece, Verileriniz, yüksek kullanılabilirlik ve küresel yedekleme sunan bir exabayt ölçekli nesne depolama çözümü olan Google Cloud Storage paketinde depolanır. Cloud Storage for Firebase, bu dosyaları güvenli bir şekilde yüklemenizi sağlar mobil cihazlardan ve web tarayıcılarından doğrudan erişim sağlayarak sağlayabilir.
Ön koşullar
Henüz yapmadıysanız Firebase'i Android projenize ekleyin.
Varsayılan Cloud Storage paketi oluşturma
Firebase konsolunun gezinme bölmesinde Depolama'yı seçin. ve Başlayın'ı tıklayın.
Güvenliği kullanarak Cloud Storage verilerinizin güvenliğini sağlama hakkındaki mesajı inceleyin kurallar. Geliştirme sürecinde herkese açık erişim kurallarınızı ayarlama hakkında daha fazla bilgi edinin.
Varsayılan konumunuz için bir konum seçin. Cloud Storage paket.
Bu konum ayarı, projenizin varsayılan Google Cloud Platform (GCP) kaynak konumudur. Bu konumun, projenizde konum ayarı gerektiren GCP hizmetleri (özellikle Cloud Firestore veritabanınız ve App Engine uygulamanız (Cloud Scheduler kullanıyorsanız gereklidir)) için kullanılacağını unutmayın.
Konum seçemiyorsanız projeniz zaten varsayılan bir GCP kaynak konumuna sahip. Bu ayar, proje oluşturma sırasında veya konum ayarı gerektiren başka bir hizmet kurulurken ayarlanmıştır.
Blaze planını kullanıyorsanız: Her biri kendine ait olan birden fazla paket oluşturun konum.
Bitti'yi tıklayın.
Herkese açık erişimi ayarlama
Cloud Storage for Firebase, aşağıdakileri yapmanıza olanak tanıyan bildirim temelli bir kural dili sağlar: verilerinizin nasıl yapılandırılacağını, nasıl dizine ekleneceğini ve ne zaman ve yazıya dökülebilir. Varsayılan olarak, Yalnızca kimliği doğrulanmış kullanıcıların okuma veya yazma işlemi yapabilmesi için Cloud Storage kısıtlıdır dışı verilerdir. Authentication ayarlarını yapmadan başlamak için kurallarınızı herkese açık erişim için yapılandırabilirsiniz.
Bu işlem, Cloud Storage hizmetini kullanmayanlar dahil olmak üzere herkese açık hale getirir Bu nedenle, kurulum sırasında Cloud Storage cihazınızı kısıtlamayı unutmayın kimlik doğrulama.
Cloud Storage SDK'sını uygulamanıza ekleyin
Modül (uygulama düzeyinde) Gradle dosyanızda (genellikle<project>/<app-module>/build.gradle.kts
veya
<project>/<app-module>/build.gradle
),
Android için Cloud Storage kitaplığına bağımlılığı ekleyin. Şunu kullanmanızı öneririz:
Firebase Android BoM
Kitaplık'ta sürüm oluşturmayı kontrol etmek için
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.4.0")) // Add the dependency for the Cloud Storage library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-storage") }
Firebase Android BoM kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.
(Alternatif) Firebase kitaplığı bağımlılıklarını kullanmadan BoM
Firebase BoM kullanmamayı seçerseniz her Firebase kitaplığı sürümünü belirtmeniz gerekir değerini alır.
Uygulamanızda birden çok Firebase kitaplığı kullanıyorsanız, kitaplık sürümlerini yönetmek için BoM kullanmanızı öneririz. Bu, tüm sürümlerin uyumlu olduğundan emin olun.
dependencies { // Add the dependency for the Cloud Storage library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-storage:21.0.1") }
Cloud Storage ayarlarını yapın
Cloud Storage paketinize erişmenin ilk adımı, FirebaseStorage
örneği oluşturmaktır:
Kotlin+KTX
storage = Firebase.storage
Java
FirebaseStorage storage = FirebaseStorage.getInstance();
Cloud Storage uygulamasını kullanmaya hazırsınız.
Öncelikle, Cloud Storage referans.
Gelişmiş kurulum
Ek kurulum gerektiren birkaç kullanım alanı vardır:
- Şu konumda Cloud Storage paket kullanılıyor: birden fazla coğrafi bölge
- Farklı depolama sınıflarında Cloud Storage paketleri kullanma
- Aynı uygulamada kimliği doğrulanmış birden fazla kullanıcıyla Cloud Storage paketlerini kullanma
Dünyanın dört bir yanında kullanıcılarınız varsa ve verilerini yakınlarında depolamak istiyorsanız ilk kullanım alanı mükemmel bir seçimdir. Örneğin, ABD'de paket oluşturabilir, Avrupa ve Asya'da bu bölgelerdeki kullanıcılara ait verileri depolayarak gecikmeyi azaltabilirsiniz.
Farklı erişim kalıplarına sahip verileriniz varsa ikinci kullanım alanı faydalıdır. Örneğin, her mağazanın teklifini içeren çok bölgeli veya bölgesel bir paket resimler, sık erişilen diğer içerikler ve Nearline veya Coldline paketi kullanıcı yedeklerini veya nadiren erişilen diğer içerikleri depolayan uygulamalar
Bu kullanım alanlarından birinde, birden fazla Cloud Storage paketi kullanın.
Üçüncü kullanım alanı, Google Drive gibi kullanıcıların birden fazla oturum açmasına (ör. kişisel hesap ve iş hesabı) olanak tanıyan bir uygulama geliştiriyorsanız kullanışlıdır. Şunları yapabilirsiniz: özel bir Firebase uygulaması kullanın örneğini kontrol edin.
Birden fazla Cloud Storage paketi kullan
Yukarıda sağlanan varsayılandan farklı 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:
Kotlin+KTX
// Get a non-default Storage bucket val storage = Firebase.storage("gs://my-custom-bucket")
Java
// Get a non-default Storage bucket FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
İçe aktarılan paketlerle çalışma
Mevcut bir Cloud Storage paketini Firebase'e aktarırken
Firebase'e
gsutil
aracı,
Google Cloud SDK'sı:
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
Proje numaranızı Firebase projeleri.
Varsayılan erişim denetimi Firebase'e izin verecek şekilde ayarlandığından bu değişiklik, yeni oluşturulan paketleri etkilemez. Bu geçici bir önlemdir ve gelecekte otomatik olarak gerçekleştirilecektir.
Özel bir Firebase uygulaması kullanın
Özel bir FirebaseApp
kullanarak daha karmaşık bir uygulama geliştiriyorsanız bu uygulamayla başlatılmış bir FirebaseStorage
örneği oluşturabilirsiniz:
Kotlin+KTX
// Get the default bucket from a custom FirebaseApp val storage = Firebase.storage(customApp!!) // Get a non-default bucket from a custom FirebaseApp val customStorage = Firebase.storage(customApp, "gs://my-custom-bucket")
Java
// Get the default bucket from a custom FirebaseApp FirebaseStorage storage = FirebaseStorage.getInstance(customApp); // Get a non-default bucket from a custom FirebaseApp FirebaseStorage customStorage = FirebaseStorage.getInstance(customApp, "gs://my-custom-bucket");
Sonraki adımlar
Uygulamanızı kullanıma sunmaya hazırlanın:
Depolama alanı gruplarınıza yalnızca uygulamalarınızın erişebilmesi için App Check seçeneğini etkinleştirin.
Bütçe ayarlama uyarılar Google Cloud konsolunda projeniz için.
Projenizin birden fazla Firebase hizmetindeki kullanımına dair genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin. Ayrıca, Cloud Storage Kullanım sayfasını da ziyaret edebilirsiniz. kontrol paneline gidin ayrıntılı kullanım bilgileridir.
Firebase lansman kontrol listesini inceleyin.