C++ için Cloud Storage'ı kullanmaya başlayın

Cloud Storage for Firebase, resim ve video gibi kullanıcı tarafından oluşturulan içerikleri yüklemenize ve paylaşmanıza olanak tanır. Böylece, uygulamalarınıza zengin medya içerikleri ekleyebilirsiniz. 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ı doğrudan mobil cihazlardan ve web tarayıcılarından güvenli bir şekilde yüklemenize olanak tanır. Böylece, bağlantının zayıf olduğu ağlarda sorun yaşamazsınız.

Başlamadan önce

Cloud Storage özelliğini kullanabilmek için:

  • C++ projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

    C++ projeniz zaten Firebase kullanıyorsa Firebase için kaydedilmiş ve yapılandırılmış demektir.

  • Firebase C++ SDK'sını C++ projenize ekleyin.

Firebase'i C++ projenize eklemenin hem Firebase konsolundaki hem de açık C++ projenizdeki görevleri içerdiğini unutmayın (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip C++ projenize taşırsınız).

Ayrıca, Firebase projenizin kullandıkça öde Blaze fiyatlandırma planı kapsamında olduğundan emin olun. Firebase ve Google Cloud'da yeniyseniz 300 ABD doları kredi almaya uygun olup olmadığınızı kontrol edin.

Varsayılan Cloud Storage paketi oluşturma

  1. Firebase konsolunun gezinme bölmesinden Depolama alanı'nı seçin.

    Projeniz henüz kullandıkça öde Blaze fiyatlandırma planında değilse projenizi yükseltmeniz istenir.

  2. Başlayın'ı tıklayın.

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

  4. Varsayılan paketiniz için Firebase Security Rules öğesini yapılandırın. Geliştirme sırasında kurallarınızı herkese açık erişim için ayarlama seçeneğini değerlendirin.

  5. Bitti'yi tıklayın.

Artık paketi Firebase konsolunun Cloud Storage Dosyalar sekmesinde görüntüleyebilirsiniz. Varsayılan paket adı biçiminiz PROJECT_ID.firebasestorage.app.

Herkese açık erişimi ayarlama

Cloud Storage for Firebase, verilerinizin nasıl yapılandırılması, nasıl dizine eklenmesi ve ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan açıklayıcı bir kural dili sağlar. Varsayılan olarak Cloud Storage için okuma ve yazma erişimi kısıtlıdır. Böylece yalnızca kimliği doğrulanmış kullanıcılar veri okuyabilir veya yazabilir. Authentication'i kurmadan başlamak için kurallarınızı herkese açık erişim için yapılandırabilirsiniz.

Bu durumda, Cloud Storage uygulamanızı kullanmayan kullanıcılar da dahil olmak üzere herkese açık hale gelir. Bu nedenle, kimlik doğrulamayı ayarlarken Cloud Storage'nizi tekrar kısıtladığınızdan emin olun.

firebase::App oluşturma ve başlatma

Cloud Storage'e erişebilmek için firebase::App öğesini oluşturup ilk kullanıma hazırlamanız gerekir.

firebase::App için başlık dosyasını ekleyin:

#include "firebase/app.h"

Android

JNI ortamını ve Java etkinliğine ait bir jobject referansını bağımsız değişken olarak ileterek firebase::App öğesini oluşturun:

app = App::Create(AppOptions(), jni_env, activity);

iOS ve üzeri

firebase::App öğesini oluşturun:

app = App::Create(AppOptions());

firebase::storage::Storage sınıfına erişme

firebase::storage::Storage sınıfı, Cloud Storage C++ SDK'sı için giriş noktasıdır.

Storage* storage = Storage::GetInstance(app);

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

Sonraki adım? Cloud Storage referansı oluşturmayı öğrenin.

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

Farklı erişim kalıplarına sahip verileriniz varsa ikinci kullanım alanı faydalıdır. Örneğin: Resimleri veya sık erişilen diğer içerikleri depolayan çok bölgeli ya da bölgesel bir paket ve kullanıcı yedeklerini veya sık erişilmeyen diğer içerikleri depolayan yakın satır veya soğuk satır paketi oluşturabilirsiniz.

Bu kullanım alanlarından herhangi birinde birden fazla Cloud Storage paketi kullanmak isteyebilirsiniz.

Üçü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. Her ek hesabın kimliğini doğrulamak için özel bir Firebase uygulaması örneği kullanabilirsiniz.

Birden fazla Cloud Storage paketi kullanma

Yukarıda sağlanan varsayılandan farklı bir Cloud Storage paketi veya tek bir uygulamada birden çok Cloud Storage paketi kullanmak istiyorsanız özel paketinize referans veren bir firebase::storage::Storage örneği oluşturabilirsiniz:

// Get a non-default Cloud Storage bucket
Storage* storage = Storage::GetInstance("gs://my-custom-bucket");

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

Mevcut bir Cloud Storage paketini Firebase'e aktarırken Google Cloud SDK'sına dahil olan gsutil aracını kullanarak Firebase'e bu dosyalara erişme izni vermeniz gerekir:

gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME

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

Bu durum, yeni oluşturulan paketleri etkilemez. Çünkü bu gruplar, varsayılan erişim denetimi Firebase'e izin verecek şekilde ayarlanır. Bu geçici bir önlemdir ve gelecekte otomatik olarak gerçekleştirilecektir.

Özel bir Firebase uygulaması kullanın

Özel bir firebase::App kullanarak daha karmaşık bir uygulama oluşturuyorsanız söz konusu uygulamayla başlatılmış bir firebase::storage::Storage örneği oluşturabilirsiniz:

// Get the default bucket from a custom firebase::App
Storage* storage = Storage::GetInstance(customApp);

// Get a non-default bucket from a custom firebase::App
Storage* storage = Storage::GetInstance(customApp, "gs://my-custom-bucket");

Sonraki adımlar