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 tworzyć w aplikacjach treści multimedialne. Twoje dane są przechowywane w zasobniku Google Cloud Storage – rozwiązaniu do obiektowej pamięci masowej o zasobach exabajtów z 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, a także łatwe radzenie sobie z problemami z siecią.
Zanim zaczniesz
Jeśli jeszcze tego nie zrobiono, przeczytaj przewodnik dla deweloperów aplikacji Flutter. Obejmuje to m.in.:
Tworzenie projektu Firebase.
Instalowanie i inicjowanie pakietów SDK Firebase dla Fluttera.
Upewnij się, że Twój projekt Firebase korzysta z abonamentu Blaze (płatność według zużycia zasobów). Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy kwalifikujesz się do otrzymania 300 USD do wykorzystania.
Tworzenie domyślnego zasobnika Cloud Storage
W panelu nawigacyjnym konsoli Firebase wybierz Przechowywanie danych.
Jeśli Twój projekt nie jest jeszcze objęty abonamentem Blaze w modelu płatności według wykorzystania, pojawi się prośba o przejście na wyższą wersję.
Kliknij Rozpocznij.
Wybierz lokalizację domyślnego zasobnika.
Zasobniki w
,US-CENTRAL1
iUS-EAST1
mogą korzystać z poziomu „Zawsze bezpłatne” dla Google Cloud Storage. Segmenty w pozostałych lokalizacjach podlegają taryfie i użytkowaniu Google Cloud Storage.US-WEST1
Jeśli chcesz, możesz później utworzyć kilka puli, z których każda będzie mieć swoją lokalizację.
Skonfiguruj Firebase Security Rules dla domyślnego zasobnika. Podczas tworzenia aplikacji rozważ skonfigurowanie reguł dostępu publicznego.
Kliknij Gotowe.
Zasobnik możesz teraz wyświetlić na karcie Cloud Storage Pliki konsoli Firebase. Domyślny format nazwy zasobnika to PROJECT_ID.firebasestorage.app
Konfigurowanie dostępu publicznego
Cloud Storage dla Firebase udostępnia język deklaratywny, który umożliwia określenie struktury danych, sposobu ich indeksowania oraz czasu, w którym 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.
Spowoduje to, że Cloud Storage będzie dostępny dla wszystkich, nawet osób, które nie korzystają z Twojej aplikacji. Pamiętaj, aby ponownie ograniczyć dostęp do Cloud Storage po skonfigurowaniu uwierzytelniania.
Dodawanie pakietu SDK Cloud Storage do aplikacji
Aby zainstalować w korzeniach projektu Flutter ten komponent, uruchom to polecenie:
flutter pub add firebase_storage
Po zakończeniu ponownie skompiluj aplikację Flutter:
flutter run
Zaimportuj wtyczkę w kodzie Darta:
import 'package:firebase_storage/firebase_storage.dart';
Konfigurowanie Cloud Storage
Uruchom
flutterfire configure
w katalogu projektu Flutter. W ten sposób aktualizujesz plik konfiguracji Firebase (firebase_options.dart
) w kodzie źródłowym aplikacji, aby miał nazwę domyślnego zasobnika Cloud Storage.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
Niektóre przypadki użycia wymagają dodatkowej konfiguracji:
- Korzystanie z zasobników Cloud Storage w wielu regionach geograficznych
- Korzystanie z zasobników Cloud Storage w różnych klasach
- Korzystanie z zasobników Cloud Storage z wieloma uwierzytelnionymi użytkownikami w tej samej aplikacji
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ć zbiory w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników z tych regionów i w ten sposób zmniejszyć opóźnienia.
Drugi przypadek użycia jest przydatny, jeśli masz dane z różnymi wzorami dostępu. Możesz na przykład skonfigurować wieloregionalny lub regionalny zasobnik do przechowywania zdjęć lub innych często używanych treści, a także zasobnik Nearline lub Coldline, w którym będą przechowywane kopie zapasowe użytkowników lub inne rzadko używane treści.
W każdym z tych przypadków warto używać 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. na konto osobiste i służbowe). Do uwierzytelniania każdego dodatkowego konta możesz użyć niestandardowej instancji aplikacji Firebase.
Korzystanie z wielu zasobników Cloud Storage
Jeśli chcesz użyć zasobnika Cloud Storage innego niż domyślny podany powyżej lub użyć 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 zaimportowanymi zasobnikami
Podczas importowania do Firebase istniejącego zasobnika Cloud Storage musisz zezwolić Firebase na dostęp do tych plików za pomocą narzędzia gsutil
, które wchodzi w skład 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 w wprowadzeniu do projektów Firebase.
Nie dotyczy to nowo utworzonych zasobników, ponieważ mają one domyślnie ustawioną kontrolę dostępu zezwalającą na dostęp do Firebase. Jest to środek tymczasowy, który w przyszłości będzie wykonywany automatycznie.
Używanie niestandardowej aplikacji Firebase
Jeśli tworzysz bardziej skomplikowaną aplikację za pomocą niestandardowego obiektu FirebaseApp
, możesz utworzyć instancję obiektu FirebaseStorage
zainicjalizowanego za pomocą tej aplikacji:
// Use a non-default App
final storage = FirebaseStorage.instanceFor(app: customApp);
Dalsze kroki
- Przygotuj się do uruchomienia aplikacji:
- Włącz Sprawdzanie aplikacji, aby mieć pewność, że tylko Twoje aplikacje mają dostęp do zasobników na dane.
- Alerty dotyczące budżetu projektu możesz skonfigurować w konsoli Google Cloud.
- Korzystając z panelu Wykorzystanie i płatności w konsoli Firebase, możesz monitorować wykorzystanie projektu w wielu usługach Firebase. Więcej szczegółowych informacji o wykorzystaniu znajdziesz na panelu Wykorzystanie Cloud Storage.
- Zapoznaj się z listą kontrolną przed wdrożeniem Firebase.