Android'de Cloud Storage'ı kullanmaya başlama

Firebase için Cloud Storage, aşağıdakiler gibi kullanıcı tarafından oluşturulan içerikleri yükleyip paylaşmanıza olanak tanır: 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 Firebase için Cloud Storage 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ölmesinden Depolama'yı seçin, ve ardından Başlayın'ı tıklayın.

  2. Güvenliği kullanarak Cloud Storage verilerinizin güvenliğini sağlamayla ilgili mesajları 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 paketi.

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

  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, Cloud Storage kısıtlı olduğundan yalnızca kimliği doğrulanmış kullanıcılar okuyabilir veya yazabilir dışı verilerdir. Kimlik doğrulama ayarını yapmadan başlamak için: genel erişim için kurallarınızı yapılandırın.

Bu sayede Cloud Storage, Bu nedenle, kurulum yaparken Cloud Storage'ınızı tekrar 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.1.2"))

    // 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'u kullanarak, Uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanacaktır.

(Alternatif) BoM'u kullanmadan Firebase kitaplığı bağımlılıklarını ekleyin

Firebase BoM'yi kullanmamayı tercih ederseniz 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. Böylece, uyumlu olur. 

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")
}
. 'nı inceleyin. 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'ı ayarlayın

Cloud Storage paketinize erişmenin ilk adımı, bir veri paketi oluşturmaktır. FirebaseStorage örneği:

Kotlin+KTX 

storage = Firebase.storage
StorageActivity.kt

Java 

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

Cloud Storage'ı kullanmaya hazırsınız.

Öncelikle Cloud Storage oluşturma işlemini 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 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 kullanabilirsiniz.

Üçü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 kullanma

Yukarıda sağlanan varsayılandan farklı bir Cloud Storage paketi kullanmak istiyorsanız tek bir uygulamada birden fazla Cloud Storage paketi kullanmak istiyorsanız, özel paketinize referans veren FirebaseStorage arasından:

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ı 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")
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