Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Android'de Cloud Storage'ı Kullanmaya Başlayın

Firebase için Bulut Depolama, uygulamalarınızda zengin medya içeriği oluşturmanıza olanak tanıyan, görüntü ve video gibi kullanıcı tarafından oluşturulan içeriği yüklemenize ve paylaşmanıza olanak tanır. Verileriniz, yüksek kullanılabilirlik ve küresel yedekliğe sahip eksabayt ölçekli bir nesne depolama çözümü olan Google Cloud Storage paketinde depolanır. Bulut Depolama, 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 ele alır.

Önkoşullar

Henüz yapmadıysanız, Android projenize Firebase'i ekleyin .

Varsayılan bir Depolama paketi oluşturun

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

  2. Güvenlik kurallarını kullanarak Depolama verilerinizin güvenliğini sağlama hakkındaki mesajı inceleyin. Geliştirme sırasında, genel erişim için kurallarınızı oluşturmayı düşünün.

  3. Varsayılan Depolama paketiniz için bir konum seçin.

    • Bu konum ayarı, projenizin varsayılan Google Cloud Platform (GCP) kaynak konumudur . Bu konumun, projenizde özellikle Cloud Firestore veritabanınız ve App Engine uygulamanız (Cloud Scheduler kullanıyorsanız gereklidir) olmak üzere bir konum ayarı gerektiren GCP hizmetleri için kullanılacağını unutmayın.

    • Konum seçemiyorsanız, projenizde zaten varsayılan bir GCP kaynak konumu vardır. Ya proje oluşturulurken ya da bir konum ayarı gerektiren başka bir hizmet kurulurken ayarlandı.

    Blaze planındaysanız, her biri kendi konumuna sahip birden çok kova oluşturabilirsiniz .

  4. Bitti'yi tıklayın.

Genel erişimi ayarlayın

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 açıklayıcı bir kural dili sağlar. Varsayılan olarak, Depolamaya okuma ve yazma erişimi kısıtlanmıştır, bu nedenle yalnızca kimliği doğrulanmış kullanıcılar verileri okuyabilir veya yazabilir. Kimlik Doğrulamayı ayarlamadan başlamak için, kurallarınızı genel erişim için yapılandırabilirsiniz .

Bu, Depolamayı herkese, hatta uygulamanızı kullanmayanlara bile açık hale getirir, bu nedenle kimlik doğrulamasını ayarlarken Depolamanızı yeniden kısıtladığınızdan emin olun.

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

Firebase Android BoM'yi kullanarak, modülünüzdeki (uygulama düzeyinde) Gradle dosyanızda (genellikle app/build.gradle ) Cloud Storage Android kitaplığının bağımlılığını app/build.gradle .

Java

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:26.3.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'
}

Firebase Android BoM'yi kullandığınızda , uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

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

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

Uygulamanızda birden çok Firebase kitaplığı kullanırsanız, kitaplık sürümlerini yönetmek için BoM'yi kullanmanızı önemle tavsiye ettiğimizi unutmayın; bu, tüm sürümlerin uyumlu olmasını sağlar.

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:19.2.1'
}

Kotlin + KTX

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:26.3.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'
}

Firebase Android BoM'yi kullandığınızda , uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

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

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

Uygulamanızda birden çok Firebase kitaplığı kullanırsanız, kitaplık sürümlerini yönetmek için BoM'yi kullanmanızı önemle tavsiye ettiğimizi unutmayın; bu, tüm sürümlerin uyumlu olmasını sağlar.

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:19.2.1'
}

Cloud Storage'ı kurun

Depolama paketinize erişmenin ilk adımı, bir FirebaseStorage örneği oluşturmaktır:

Java

FirebaseStorage storage = FirebaseStorage.getInstance();

Kotlin + KTX

storage = Firebase.storage

Cloud Storage'ı kullanmaya başlamaya hazırsınız!

Öncelikle, bir Bulut Depolama referansı oluşturmayı öğrenelim.

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 örneği mükemmeldir. Örneğin, gecikmeyi azaltmak için bu bölgelerdeki kullanıcılar için verileri depolamak üzere ABD, Avrupa ve Asya'da paketler oluşturabilirsiniz.

İkinci kullanım örneği, farklı erişim modellerine sahip verileriniz varsa faydalıdır. Örneğin: resimleri veya diğer sık ​​erişilen içeriği depolayan çok bölgeli veya bölgesel bir paket ve kullanıcı yedeklemelerini veya diğer nadiren erişilen içeriği depolayan bir nearline veya soğuk hat grubu oluşturabilirsiniz.

Bu kullanım durumlarından herhangi birinde, birden çok depolama paketi kullanmak isteyeceksiniz.

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

Birden çok depolama kovası kullanın

Yukarıda sağlanan varsayılandan farklı bir depolama paketi kullanmak veya tek bir uygulamada birden çok depolama paketi kullanmak istiyorsanız, özel FirebaseStorage başvuran bir FirebaseStorage örneği oluşturabilirsiniz:

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 kovalarla çalışma

Mevcut bir Cloud Storage paketini Firebase'e aktarırken, gsutil Google Cloud SDK'da bulunan gsutil aracını kullanarak bu dosyalara erişim izni vermeniz gerekir:

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

Proje numaranızı Firebase projelerine giriş bölümünde açıklandığı gibi bulabilirsiniz.

Bu, yeni oluşturulan paketleri etkilemez, çünkü bunlar Firebase'e izin verecek şekilde varsayılan erişim kontrolüne sahiptir. Bu geçici bir önlemdir ve gelecekte otomatik olarak uygulanacaktır.

Özel bir Firebase Uygulaması kullanın

Özel bir FirebaseApp kullanarak daha karmaşık bir uygulama oluşturuyorsanız, o uygulamayla başlatılmış bir FirebaseStorage örneği oluşturabilirsiniz:

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