Wprowadzenie do Cloud Storage w C++

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści generowanych przez użytkowników, takich jak obrazy i filmy, co pozwala na tworzenie w aplikacjach treści rich media. Twoje dane są przechowywane w Google Cloud Storage zasobniku – rozwiązaniu do przechowywania obiektów o skali eksabajtów, które charakteryzuje się wysoką dostępnością i globalną redundancją. Cloud Storage for Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, a także łatwe radzenie sobie z niestabilnymi sieciami.

Zanim zaczniesz

Zanim zaczniesz korzystać z Cloud Storage, musisz:

  • zarejestrować projekt C++ i skonfigurować go do korzystania z Firebase.

    Jeśli Twój projekt C++ korzysta już z Firebase, jest on już zarejestrowany i skonfigurowany do korzystania z Firebase.

  • dodać pakiet Firebase C++ SDK do projektu C++.

Pamiętaj, że dodanie Firebase do projektu C++ wymaga wykonania zadań zarówno w Firebase konsoli Firebase, jak i w otwartym projekcie C++ (np. pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do projektu C++).

Upewnij się też, że Twój projekt Firebase korzysta z abonamentu Blaze (płatność według zużycia zasobów), który jest wymagany od października 2024 r. (zobacz nasze najczęstsze pytania). Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy kwalifikujesz się do otrzymania kredytu w wysokości 300 USD.

Tworzenie domyślnego zasobnikaCloud Storage

  1. W panelu nawigacyjnym konsoli Firebase wybierz Przechowywanie danych.

    Jeśli Twój projekt nie korzysta jeszcze z abonamentu Blaze (płatność według wykorzystania), pojawi się prośba o przejście na wyższy abonament.

  2. Kliknij Rozpocznij.

  3. Wybierz lokalizację domyślnego zasobnika.

  4. Skonfiguruj Firebase Security Rules dla domyślnego zasobnika. Podczas programowania, rozważ skonfigurowanie reguł dotyczących dostępu publicznego.

  5. Kliknij Gotowe.

Teraz możesz wyświetlić zasobnik na karcie Cloud Storage Pliki konsoli.Firebase Format nazwy domyślnego zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia deklaratywny język reguł, który umożliwia określenie struktury danych, sposobu ich indeksowania oraz tego, kiedy dane można odczytywać i zapisywać. Domyślnie dostęp do odczytu i zapisu w Cloud Storage jest ograniczony, więc tylko uwierzytelnieni użytkownicy mogą odczytywać i zapisywać dane. Aby rozpocząć korzystanie z Cloud Storage bez konfigurowania Authentication, możesz skonfigurować reguły dotyczące dostępu publicznego.

Spowoduje to, że Cloud Storage będzie otwarty dla wszystkich, nawet dla osób, które nie korzystają z Twojej aplikacji. Pamiętaj, aby po skonfigurowaniu uwierzytelniania ponownie ograniczyć dostęp do Cloud Storage.

Tworzenie i inicjowanie firebase::App

Zanim uzyskasz dostęp do Cloud Storage, musisz utworzyć i zainicjować firebase::App.

Dołącz plik nagłówkowy firebase::App:

#include "firebase/app.h"

Android

Utwórz firebase::App, przekazując środowisko JNI i odwołanie jobject do aktywności Java jako argumenty:

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

iOS+

Utwórz firebase::App:

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

Uzyskiwanie dostępu do zajęć firebase::storage::Storage

Klasa firebase::storage::Storage jest punktem wejścia do pakietu Cloud Storage C++ SDK.

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

Możesz już zacząć korzystać z Cloud Storage!

Następny krok? Dowiedz się, jak utworzyć odwołanie.Cloud Storage

Konfiguracja zaawansowana

Istnieje kilka przypadków użycia, które wymagają dodatkowej konfiguracji:

Pierwszy przypadek użycia jest idealny, jeśli masz użytkowników na całym świecie i chcesz przechowywać ich dane w pobliżu. Możesz na przykład utworzyć zasobniki w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników z tych regionów i zmniejszyć opóźnienie.

Drugi przypadek użycia jest przydatny, jeśli masz dane o różnych wzorcach dostępu. Możesz na przykład skonfigurować zasobnik wieloregionowy lub regionalny, w którym będą przechowywane zdjęcia lub inne często używane treści, oraz zasobnik nearline lub coldline, w którym będą przechowywane kopie zapasowe użytkowników lub inne rzadko używane treści.

W obu tych przypadkach użycia warto korzystać z kilku Cloud Storage zasobników.

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom korzystanie z kilku zalogowanych kont (np. konta osobistego i konta służbowego). Do uwierzytelniania każdego dodatkowego konta możesz użyć niestandardowej instancji aplikacji Firebase.

Korzystanie z kilku zasobników Cloud Storage

Jeśli chcesz używać innego zasobnika Cloud Storage niż domyślny podany powyżej, lub używać kilku zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję elementu firebase::storage::Storage, która odwołuje się do Twojego niestandardowego zasobnika:

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

Praca z importowanymi zasobnikami

Podczas importowania istniejącego zasobnika Cloud Storage do Firebase musisz przyznać Firebase możliwość dostępu do tych plików za pomocą narzędzia gsutil które jest częścią Google Cloud SDK:

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

Numer projektu znajdziesz w sekcji Wprowadzenie do projektów Firebase.

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślne ustawienia kontroli dostępu, które zezwalają na dostęp do Firebase. Jest to środek tymczasowy, który w przyszłości będzie wykonywany automatycznie.

Korzystanie z niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej złożoną aplikację, która korzysta z niestandardowej firebase::App, możesz utworzyć instancję firebase::storage::Storage zainicjowaną za pomocą tej aplikacji:

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

Dalsze kroki