Pierwsze kroki z Cloud Storage w technologii Flutter

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści takich jak obrazy, dźwięk, filmy i inne pliki (w tym treści generowane przez użytkowników), 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, które zapewnia wysoką dostępność i globalną nadmiarowość. 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

  1. Jeśli jeszcze nie masz za sobą tego kroku, zapoznaj się z przewodnikiem dla początkujących dotyczącym aplikacji Flutter. Obejmuje to m.in.:

    • Tworzenie projektu w Firebase.

    • instalowanie i inicjowanie pakietów SDK Firebase dla Fluttera,

  2. Upewnij się, ż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 możesz skorzystać z bezpłatnego okresu próbnego, w którym masz do dyspozycji środki w wysokości 300 USD.

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 (Bazy danych i pamięć masowa) > Storage (Pamięć masowa) > Files (Pliki)). Domyślny format nazwy zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage dla Firebase udostępnia deklaratywny język reguł, który pozwala określić, jak dane mają być uporządkowane 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 Uwierzytelniania Firebase, możesz skonfigurować reguły dostępu publicznego.

Dzięki temu Cloud Storage będzie dostępny dla każdego, nawet dla osób, które nie korzystają z Twojej aplikacji. Dlatego pamiętaj, aby po skonfigurowaniu uwierzytelniania ponownie ograniczyć dostęp do Cloud Storage.

Dodawanie pakietu Cloud Storage SDK do aplikacji

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

    flutter pub add firebase_storage

  2. Gdy to zrobisz, ponownie skompiluj aplikację Flutter:

    flutter run

  3. Zaimportuj wtyczkę do kodu Dart:

    import 'package:firebase_storage/firebase_storage.dart';

Konfigurowanie Cloud Storage

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

  2. Uzyskaj dostęp do zasobnika Cloud Storage, tworząc 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.

Co dalej? 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 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, który przechowuje zdjęcia lub inne często używane treści, oraz zasobnik Nearline lub Coldline, który przechowuje 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 logowanie się na kilka kont (np. konto osobiste i konto służbowe). Aby uwierzytelnić każde konto dodatkowe, możesz użyć niestandardowej instancji aplikacji w Firebase.

Używanie wielu zasobników Cloud Storage

Jeśli chcesz użyć innego zasobnika Cloud Storage niż domyślny podany powyżej lub użyć wielu 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 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 SDK Google Cloud:

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 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ę przy użyciu niestandardowego elementu FirebaseApp, możesz utworzyć instancję FirebaseStorage zainicjowaną za pomocą tej aplikacji:

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

Dalsze kroki