Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

C ++ için Cloud Storage ile bir Cloud Storage referansı oluşturun

Dosyalarınız bir Cloud Storage paketinde saklanır. Bu paketteki dosyalar, yerel sabit diskinizdeki dosya sistemi veya Firebase Realtime Database'deki veriler gibi hiyerarşik bir yapıda sunulur. Bir dosyaya referans oluşturduğunuzda, uygulamanız dosyaya erişim kazanır. Bu referanslar daha sonra verileri yüklemek veya indirmek, meta verileri almak veya güncellemek veya dosyayı silmek için kullanılabilir. Bir referans, belirli bir dosyaya veya hiyerarşideki daha yüksek seviyeli bir düğüme işaret edebilir.

Firebase Gerçek Zamanlı Veritabanını kullandıysanız , bu yollar size çok tanıdık gelecektir. Ancak, dosya verileriniz Gerçek Zamanlı Veritabanında değil Cloud Storage'da saklanır.

Referans Oluşturun

Bir dosyayı yüklemek, indirmek veya silmek ya da meta verilerini almak veya güncellemek için bir referans oluşturun. Bir referans, buluttaki bir dosyaya işaretçi olarak düşünülebilir. Referanslar hafiftir, böylece ihtiyacınız olduğu kadar çok şey oluşturabilirsiniz. Ayrıca birden fazla işlem için yeniden kullanılabilirler.

Referanslar, GetReferenceFromUrl() yöntemini çağırarak ve gs://<your-cloud-storage-bucket> biçiminde bir URL'yi ileterek GetReferenceFromUrl() uygulamanızdaki storage hizmetinden oluşturulur. Bu URL'yi Firebase konsolunun Depolama bölümünde bulabilirsiniz.

// Get a reference to the storage service, using the default Firebase App
Storage* storage = Storage::GetInstance(app);

// Create a Cloud Storage reference from our storage service
StorageReference storage_ref = storage->GetReferenceFromUrl("gs://<your-cloud-storage-bucket>");

Mevcut bir referansta child yöntemi kullanarak ağaçta daha aşağıda bir konuma, örneğin 'images/space.jpg' için bir referans oluşturabilirsiniz.

// Create a child reference
// images_ref now points to "images"
StorageReference images_ref = storage_ref.Child("images");

// Child references can also take paths delimited by '/'
// space_ref now points to "images/space.jpg"
// images_ref still points to "images"
StorageReference space_ref = storage_ref.Child("images/space.jpg");

// This is equivalent to creating the full reference
StorageReference space_ref = storage.GetReferenceFromUrl("gs://<your-cloud-storage-bucket>/images/space.jpg");

Dosya hiyerarşimizde gezinmek için Parent ve Root yöntemlerini de kullanabilirsiniz. Parent , bir seviye yukarı ilerlerken, Root en üste kadar ilerler.

// Parent allows us to move to the parent of a reference
// images_ref now points to 'images'
StorageReference images_ref = space_ref.Parent();

// Root allows us to move all the way back to the top of our bucket
// root_ref now points to the root
StorageReference root_ref = space_ref.Root();

Child , Parent ve Root her geri dönüş referans olarak, birlikte birden fazla kez zincirli olabilir. Bunun istisnası, geçersiz bir StorageReference olan Root Parent StorageReference .

// References can be chained together multiple times
// earth_ref points to "images/earth.jpg"
StorageReference earth_ref = space_ref.Parent().Child("earth.jpg");

// null_ref is null, since the parent of root is an invalid StorageReference
StorageReference null_ref = space_ref.Root().Parent();

Referans Yöntemleri

Sen en iyisi kullanarak onlar işaret dosyaları anlamak için başvurular inceleyebilir full_path , name ve bucket yöntemleri. Bu yöntemler dosyanın tam yolunu, adını ve paketini alır.

// Reference's path is: "images/space.jpg"
// This is analogous to a file path on disk
space_ref.full_path();

// Reference's name is the last segment of the full path: "space.jpg"
// This is analogous to the file name
space_ref.name();

// Reference's bucket is the name of the Cloud Storage bucket where files are stored
space_ref.bucket();

Referanslara İlişkin Sınırlamalar

Referans yolları ve adlar, herhangi bir geçerli Unicode karakter dizisi içerebilir, ancak aşağıdakiler de dahil olmak üzere belirli kısıtlamalar getirilir:

  1. Reference.fullPath'in toplam uzunluğu UTF-8 kodlandığında 1 ile 1024 bayt arasında olmalıdır.
  2. Satır Başı veya Satır Besleme karakterleri yok.
  3. # , [ , ] , * Veya ? , çünkü bunlar Firebase Realtime Database veya gsutil gibi diğer araçlarla iyi çalışmaz.

Tam Örnek

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

// Points to the root reference
StorageReference storage_ref = storage->GetReferenceFromUrl("gs://<your-bucket-name>");

// Points to "images"
StorageReference images_ref = storage_ref.Child("images");

// Points to "images/space.jpg"
// Note that you can use variables to create child values
std::string filename = "space.jpg";
StorageReference space_ref = images_ref.Child(filename);

// File path is "images/space.jpg"
std::string path = space_ref.full_path()

// File name is "space.jpg"
std::string name = space_ref.name()

// Points to "images"
StorageReference images_ref = space_ref.Parent();

Sonraki adımlar

Şimdi dosyaları Cloud Storage'a nasıl yükleyeceğimizi öğrenelim.