Wprowadzenie do Cloud Storage w C++

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści użytkowników, takich jak obrazy i filmy, co pozwala na tworzenie treści multimedialnych w aplikacjach. Twoje dane są przechowywane w zasobniku Google Cloud Storage – rozwiązaniu do przechowywania obiektów w skali eksabajtów o wysokiej dostępności i globalnej nadmiarowości. Cloud Storage for Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, bez problemu radząc sobie z niestabilnymi sieciami.

Zanim zaczniesz

Zanim zaczniesz korzystać z Cloud Storage, musisz:

  • Zarejestruj projekt C++ i skonfiguruj go tak, aby korzystał z Firebase.

    Jeśli Twój projekt C++ korzysta już z Firebase, jest już zarejestrowany i skonfigurowany pod kątem Firebase.

  • Dodaj pakiet Firebase C++ SDK do projektu C++.

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

Upewnij się też, że Twój projekt w Firebase jest objęty abonamentem Blaze z płatnością według wykorzystania, który jest wymagany do korzystania z Cloud Storage for Firebase. Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy kwalifikujesz się do otrzymania środków w wysokości 300 USD na bezpłatny okres próbny.

Tworzenie domyślnego zasobnika Cloud Storage

  1. W konsoli Firebase kliknij Bazy danych i miejsce na dane > Miejsce na dane.

    Jeśli Twój projekt nie jest jeszcze objęty abonamentem Blaze z płatnością według wykorzystania, pojawi się prośba o jego uaktualnienie.

  2. Kliknij Rozpocznij.

  3. Wybierz lokalizację domyślnego zasobnika.

  4. Skonfiguruj Firebase Security Rules dla domyślnego zasobnika. Podczas tworzenia aplikacji rozważ skonfigurowanie reguł dostępu publicznego.

  5. Kliknij Gotowe.

Możesz teraz wyświetlić zasobnik w konsoli Firebase (otwórz kartę Databases & Storage > Storage > Files). Domyślny format nazwy zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia deklaratywny język reguł, który pozwala określić, jak dane mają być ustrukturyzowane i indeksowane oraz kiedy można je 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ąć bez konfigurowania Authentication, możesz skonfigurować reguły dostępu publicznego.

Dzięki temu Cloud Storage będzie otwarty dla wszystkich, nawet dla osób, które nie korzystają z Twojej aplikacji, więc pamiętaj, aby ponownie ograniczyć Cloud Storage po skonfigurowaniu uwierzytelniania.

Tworzenie i inicjowanie firebase::App

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

Dołącz plik nagłówka dla firebase::App:

#include "firebase/app.h"

Android

Utwórz obiekt 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());

Dostęp do klasy firebase::storage::Storage

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

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

Możesz już zacząć korzystać z usługi Cloud Storage.

Co dalej? Dowiedz się, jak utworzyć plik referencyjny 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 blisko nich. 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óźnienia.

Drugi przypadek użycia jest przydatny, jeśli masz dane o różnych wzorcach dostępu. Możesz na przykład skonfigurować zasobnik w wielu regionach lub w jednym regionie, 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 warto użyć wielu zasobników Cloud Storage.

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom zalogowanie się na kilka kont (np. konto osobiste i konto służbowe). Możesz użyć niestandardowej instancji aplikacji w Firebase, aby uwierzytelnić każde konto dodatkowe.

Używanie wielu zasobników Cloud Storage

Jeśli chcesz użyć zasobnika Cloud Storage innego niż domyślny podany powyżej lub użyć wielu zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję 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 zaimportowanymi 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ą pakietu Google Cloud SDK:

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

Numer projektu znajdziesz zgodnie z opisem we wprowadzeniu do projektów w Firebase.

Nie dotyczy to nowo utworzonych zasobników, ponieważ mają one domyślną kontrolę dostępu ustawioną na zezwalanie na Firebase. Jest to środek tymczasowy, który w przyszłości będzie wykonywany automatycznie.

Używanie niestandardowej aplikacji w Firebase

Jeśli tworzysz bardziej skomplikowaną aplikację z niestandardowym obiektem 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