Catch up on everthing we announced at this year's Firebase Summit. Learn more

Android'de Cloud Storage'ı kullanmaya başlayın

Firebase için Cloud Storage, uygulamalarınızda zengin medya içeriği oluşturmanıza olanak tanıyan, görüntüler ve video gibi kullanıcı tarafından oluşturulan içeriği yüklemenize ve paylaşmanıza olanak tanır. Kişisel veriler saklanır , Google Cloud Storage yüksek kullanılabilirlik ve küresel bir yedekleme sistemine sahip exabayt ölçekli nesne depolama çözümü - kova. Firebase için Cloud Storage, bu dosyaları doğrudan mobil cihazlardan ve web tarayıcılarından güvenli bir şekilde yüklemenize olanak tanır ve sivilceli ağları kolaylıkla yönetir.

Önkoşullar

Eğer henüz yapmadıysanız, Android projeye Firebase ekleyin .

Varsayılan bir Bulut Depolama paketi oluşturun

  1. Gezinti bölmesinde itibaren Firebase konsolunda , Depolama seçin, sonra başlayın tıklayın.

  2. Güvenlik kurallarını kullanarak Bulut Depolama verilerinizin güvenliğini sağlamaya ilişkin mesajları inceleyin. Gelişme sırasında, dikkate kamu erişim için kurallar belirleyerek .

  3. Bir seçiniz yeri varsayılan Cloud Storage için.

    • Bu konum ayarı projenizin olduğunu varsayılan Google Cloud Platformu (GSO) kaynak yeri . Bu konum özellikle bir konum ayarı gerektiren proje, sizin de GSO hizmetleri için kullanılacağını Not Bulut Firestore veritabanı ve App Engine (Cloud Zamanlayıcı kullanma durumunda gereklidir) app.

    • Bir konum seçemiyorsanız, projenizin zaten bir varsayılan GCP kaynak konumu vardır. Ya proje oluşturma sırasında ya da bir konum ayarı gerektiren başka bir hizmet kurulurken ayarlandı.

    Eğer Blaze planını kullanıyorsanız yapabilirsiniz birden grup oluştururuz , kendi ile her konumda .

  4. Bitti tıklayın.

Herkese açık erişimi ayarla

Firebase için Cloud Storage, verilerinizin nasıl yapılandırılması gerektiğini, nasıl dizine eklenmesi gerektiğini ve verilerinizin ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan bildirime dayalı bir kurallar dili sağlar. Varsayılan olarak, Cloud Storage'a okuma ve yazma erişimi kısıtlanmıştır, böylece yalnızca kimliği doğrulanmış kullanıcılar veri okuyabilir veya yazabilir. Ayarlamadan Başlamak için Authentication yapabilirsiniz kamu erişim için kuralları yapılandırmak .

Bu, Cloud Storage'ı uygulamanızı kullanmayan kişiler dahil herkese açık hale getirir, bu nedenle kimlik doğrulamayı ayarlarken Cloud Storage'ınızı tekrar kısıtladığınızdan emin olun.

Uygulamanıza Cloud Storage SDK'sını ekleyin

Kullanılması Firebase Android Bom , senin modülü (uygulama düzeyinde) Gradle dosyası (genellikle Bulut Depolama Android kütüphanesi için bağımlılık beyan app/build.gradle ).

Java

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:29.0.0')

    // Declare 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'
}

Kullanarak Firebase Android Bom , uygulamanızın her zaman Firebase Android kütüphanelerin uyumlu versiyonlarını kullanacak.

(Alternatif) Bom kullanmadan Firebase kütüphane bağımlılıklarını beyan

Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.

Eğer uygulamanızda birden Firebase kitaplıkları kullanırsanız, biz çok tüm versiyonlar uyumlu olmasını sağlar kütüphane sürümlerini yönetmek için Bom kullanmanızı öneririz olduğunu unutmayın.

dependencies {
    // Declare 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:20.0.0'
}

Kotlin+KTX

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:29.0.0')

    // Declare 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-ktx'
}

Kullanarak Firebase Android Bom , uygulamanızın her zaman Firebase Android kütüphanelerin uyumlu versiyonlarını kullanacak.

(Alternatif) Bom kullanmadan Firebase kütüphane bağımlılıklarını beyan

Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.

Eğer uygulamanızda birden Firebase kitaplıkları kullanırsanız, biz çok tüm versiyonlar uyumlu olmasını sağlar kütüphane sürümlerini yönetmek için Bom kullanmanızı öneririz olduğunu unutmayın.

dependencies {
    // Declare 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-ktx:20.0.0'
}

Cloud Storage'ı kurun

Cloud Storage grup erişimin ilk adımı bir örneğini oluşturmaktır FirebaseStorage :

Java

FirebaseStorage storage = FirebaseStorage.getInstance();

Kotlin+KTX

storage = Firebase.storage

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

İlk olarak, öğrenelim bir Cloud Storage referans oluşturmak .

Gelişmiş kurulum

Ek kurulum gerektiren birkaç kullanım durumu vardır:

Dünyanın her yerinden kullanıcılarınız varsa ve verilerini yanlarında depolamak istiyorsanız, ilk kullanım durumu mükemmeldir. Örneğin, gecikmeyi azaltmak amacıyla ABD, Avrupa ve Asya'da bu bölgelerdeki kullanıcılar için veri depolamak üzere paketler oluşturabilirsiniz.

Farklı erişim modellerine sahip verileriniz varsa, ikinci kullanım durumu yararlıdır. Örneğin: resimleri veya sık erişilen diğer içerikleri depolayan çok bölgeli veya bölgesel bir grup ve kullanıcı yedeklerini veya seyrek erişilen diğer içerikleri depolayan bir yakın hat veya soğuk hat grubu oluşturabilirsiniz.

Bu örneklerden birinde, isteyeceksiniz birden Bulut Depolama kepçeler kullanılır .

Üçüncü kullanım örneği, Google Drive gibi, kullanıcıların birden fazla oturum açmış hesabı (örneğin, bir kişisel hesap ve bir iş hesabı) olmasına izin veren bir uygulama oluşturuyorsanız kullanışlıdır. Sen olabilir özel bir Firebase App kullanmak her ek hesap kimliğini doğrulamak için örnek.

Birden çok Cloud Storage paketi kullanın

Bir Bulut Depolama kullanmak istiyorsanız kova varsayılan Yukarıda verilen veya tek bir uygulamada birden Bulut Depolama kova kullanmak dışında, sen bir örneğini oluşturabilir FirebaseStorage referanslar özel kova olun:

Java

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

Kotlin+KTX

// Get a non-default Storage bucket
val storage = Firebase.storage("gs://my-custom-bucket")

İçe aktarılan paketlerle çalışma

Firebase içine varolan Bulut Depolama kova içe aktarırken, Firebase kullanarak bu dosyalara erişmek için iznini gerekecek gsutil dahil aracını Google Bulut SDK :

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Açıklandığı şekilde Proje numaranızı bulabilirsiniz Firebase projelerine giriş .

Firebase'e izin vermek için varsayılan erişim kontrolüne sahip olduklarından, bu 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 kullanarak daha karmaşık app inşa ediyorsanız FirebaseApp , sen bir örneğini oluşturabilir FirebaseStorage bu uygulamayla başlatıldı:

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

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

Sonraki adımlar