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 şurada saklanır: Google Cloud Storage paketi — bir yüksek kullanılabilirlik ve global boyut sunan eksabayt ölçekli nesne depolama çözümü İşten çıkarma 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ştur
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 konumu. Bu konumun, projenizdeki GCP hizmetleri için kullanılacağını unutmayın konum ayarı gerektiren durumlar, özellikle de Cloud Firestore veritabanı ve App Engine uygulaması (Cloud Scheduler kullanıyorsanız bu gereklidir).
Konum seçemiyorsanız projeniz zaten varsayılan bir GCP kaynak konumuna sahip. Proje sırasında konum gerektiren başka bir hizmet ayarlarken ayarını değiştirebilirsiniz.
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'i kurmadan başlamak için: genel erişim için kurallarınızı yapılandırın.
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.2.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 her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanacaktı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.0") }
Cloud Storage ayarlarını yapın
Cloud Storage paketinize erişmenin ilk adımı, bir
FirebaseStorage
örneği:
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
- Şu konumda Cloud Storage paket kullanılıyor: farklı depolama sınıfları
- 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 ilk kullanım alanı mükemmeldir. bu verileri yakınlarında saklar. Örneğin, ABD'de paket oluşturabilir, Avrupa ve Asya'da bu bölgelerdeki kullanıcılara ait verileri depolayarak gecikmeyi azaltabilirsiniz.
İkinci kullanım alanı, farklı erişim kalıplarına sahip verileriniz varsa yararlı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ı, örneğin Google Drive gibi bir uygulama oluşturuyorsanız kullanışlıdır. Kullanıcıların giriş yapmış birden fazla hesaba (örneğin, kişisel bir hesap) sahip olmasına olanak tanır ve bir iş hesabı). Ş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 isterseniz:
veya tek bir uygulamada birden fazla Cloud Storage paketi kullanmak istiyorsanız örnek oluşturabilirsiniz
özel paketinize referans veren FirebaseStorage
arasından:
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ı projenin Firebase projeleri.
Yeni oluşturulan paketler varsayılan erişime sahip olduğundan bu işlem yeni oluşturulan paketleri etkilemez kontrolü Firebase'e izin verecek şekilde ayarlandı. Bu geçici bir çözümdür ve otomatik olarak yapılır.
Özel bir Firebase uygulaması kullanın
Özel bir FirebaseApp
kullanarak daha karmaşık bir uygulama oluşturuyorsanız şunları yapabilirsiniz:
şu uygulamayla başlatılan bir FirebaseStorage
örneğini oluşturun:
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ırlanma:
App Check özelliğini etkinleştirerek yalnızca şunlardan emin olun: uygulamalarınız depolama alanı gruplarınıza erişebilir.
Bütçe ayarlama uyarılar Google Cloud konsolunda projeniz için.
Kullanımı ve faturalandırmayı izleme kontrol paneli projenizin genel durumunu görmek için Firebase konsolunda birden fazla Firebase hizmetinde nasıl kullanıldığını gösterir. İsterseniz Cloud Storage Kullanım sayfasını da ziyaret edebilirsiniz. kontrol paneli ayrıntılı kullanım bilgileridir.
Firebase lansmanı kontrol listesini inceleyin.