Android'de Cloud Storage'ı kullanmaya başlama

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

  1. Firebase konsolunun gezinme bölmesinde Depolama'yı seçin. ve Başlayın'ı tıklayın.

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

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

  4. 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")
}
 Kotlin'e özel bir kitaplık modülü mü arıyorsunuz? Başlamak için kalan süre: Ekim 2023 (Firebase BoM 32.5.0), hem Kotlin hem de Java geliştiricileri (ayrıntılar için bkz. Bu girişimle ilgili SSS).

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
StorageActivity.kt

Java 

FirebaseStorage storage = FirebaseStorage.getInstance();
StorageActivity.java

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:

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")
StorageActivity.kt

Java 

// Get a non-default Storage bucket
FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
StorageActivity.java

İç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")
StorageActivity.kt

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");
StorageActivity.java

Sonraki adımlar