Pierwsze kroki z Cloud Storage w technologii Flutter

Cloud Storage dla 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 multimedialnych. Twoje dane są przechowywane w zasobniku Google Cloud Storage – rozwiązaniu do przechowywania obiektów o skali eksabajtów, które charakteryzuje się wysoką dostępnością i globalną redundancją. Cloud Storage dla Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, z łatwością radząc sobie z niestabilnymi sieciami.

Zanim zaczniesz

  1. Jeśli jeszcze tego nie zrobisz, zapoznaj się z przewodnikiem dla początkujących dotyczącym aplikacji Flutter. Obejmuje to:

    • tworzenie projektu w Firebase,

    • instalowanie i inicjowanie pakietów Firebase SDK dla Flutter.

  2. Upewnij się, że Twój projekt w Firebase korzysta z planu taryfowego Blaze (płatność 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 bezpłatnego okresu próbnego o wartości 300 USD.

Tworzenie domyślnego zasobnika Cloud Storage

  1. W konsoli Firebase otwórz Bazy danych i miejsce na dane > Miejsce na dane.

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

  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.

Teraz możesz wyświetlić zasobnik w konsoli Firebase (otwórz kartę Bazy danych i miejsce na dane > Miejsce na dane > Pliki). Format nazwy domyślnego zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage dla Firebase udostępnia deklaratywny język reguł, który umożliwia określenie struktury danych, sposobu ich indeksowania oraz tego, kiedy można je odczytywać i zapisywać. Domyślnie dostęp do odczytu i zapisu w Cloud Storage jest ograniczony, dzięki czemu tylko uwierzytelnieni użytkownicy mogą odczytywać i zapisywać dane. Aby rozpocząć bez konfigurowania uwierzytelniania Firebase, możesz skonfigurować reguły 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.

Dodawanie pakietu Cloud Storage SDK do aplikacji

  1. W katalogu głównym projektu Flutter uruchom to polecenie, aby zainstalować wtyczkę:

    flutter pub add firebase_storage

  2. Po zakończeniu ponownie skompiluj aplikację Flutter:

    flutter run

  3. Zaimportuj wtyczkę w kodzie Dart:

    import 'package:firebase_storage/firebase_storage.dart';

Konfigurowanie Cloud Storage

  1. W katalogu projektu Flutter uruchom polecenie flutterfire configure. Spowoduje to zaktualizowanie pliku konfiguracji Firebase (firebase_options.dart) w bazie kodu aplikacji tak, aby zawierał nazwę domyślnego zasobnika Cloud Storage.

  2. Aby uzyskać dostęp do zasobnika Cloud Storage, utwórz instancję FirebaseStorage:

    final storage = FirebaseStorage.instance;

// Alternatively, explicitly specify the bucket name URL.
// final storage = FirebaseStorage.instanceFor(bucket: "gs://<var>BUCKET_NAME</var>");

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

Następny krok? Dowiedz się, jak utworzyć odwołanie do 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 obejmujący wiele regionów lub region, 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 zasobników Cloud Storage.

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom logowanie się na kilka kont (np. konto osobiste i konto służbowe). 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 lub używać kilku zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję FirebaseStorage, która odwołuje się do niestandardowego zasobnika:

// Get a non-default Storage bucket
final storage = FirebaseStorage.instanceFor(bucket: "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ą gsutil narzędzia zawartego w pakiecie Google Cloud SDK:

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

Numer projektu znajdziesz w sposób opisany we wprowadzeniu do projektów Firebase.

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślną kontrolę dostępu ustawioną tak, aby zezwalać 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ę przy użyciu niestandardowej aplikacji FirebaseApp, możesz utworzyć instancję FirebaseStorage zainicjowaną za pomocą tej aplikacji:

// Use a non-default App
final storage = FirebaseStorage.instanceFor(app: customApp);

Dalsze kroki