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 multimedialnych. Twoje dane są przechowywane w zasobniku Google Cloud Storage – rozwiązaniu do przechowywania obiektów o rozmiarze exabajtów z wysoką dostępnością i globalną redundancją. Cloud Storage for Firebase umożliwia bezpieczne przesyłanie takich plików bezpośrednio z urządzeń mobilnych i przeglądarek, co pozwala łatwo obsługiwać niestabilne sieci.
Zanim zaczniesz
Upewnij się, że znasz też przewodnik dla początkujących użytkowników aplikacji na Androida. Obejmuje to m.in.:
Tworzenie projektu Firebase.
Zarejestruj aplikację na Androida w projekcie i połącz ją z Firebase, dodając do niej zależności Firebase, wtyczkę usług Google i plik konfiguracji Firebase (
google-services.json
).
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 cennikiem Blaze, pojawi się prośba o zaktualizowanie projektu.
Kliknij Rozpocznij.
Wybierz lokalizację domyślnego zasobnika.
Grupy w poziomie
,US-CENTRAL1
iUS-EAST1
mogą korzystać z poziomu „Zawsze bezpłatnie” w przypadku 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 zasobnika domyślnego. 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 for Firebase udostępnia język deklaratywny, który pozwala określić, jak dane powinny być ustrukturyzowane, jak powinny być indeksowane oraz kiedy można je odczytywać i zapisywać. Domyślnie dostęp do odczytu i zapisu do 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.
W ten sposób Cloud Storage będzie dostępne 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 do aplikacji pakietu SDK Cloud Storage
W pliku Gradle (na poziomie modułu) modułu (na poziomie aplikacji) (zwykle<project>/<app-module>/build.gradle.kts
lub <project>/<app-module>/build.gradle
) dodaj zależność z biblioteką Cloud Storage na Androida. Zalecamy używanie Firebase Android BoM do kontrolowania wersji biblioteki.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.5.1")) // Add the dependency for the Cloud Storage library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-storage") }
Dzięki użyciu Firebase Android BoMaplikacja zawsze będzie używać zgodnych wersji bibliotek Firebase na Androida.
(Alternatywnie) Dodaj zależności biblioteki Firebase bez używania pakietu BoM
Jeśli zdecydujesz się nie używać obiektu Firebase BoM, musisz określić każdą wersję biblioteki Firebase w wierszu zależności.
Jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek. Dzięki temu wszystkie wersje będą ze sobą zgodne.
dependencies { // Add the dependency for the Cloud Storage library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-storage:21.0.1") }
Skonfiguruj usługę Cloud Storage w aplikacji
Sprawdź, czy plik konfiguracji Firebase (
google-services.json
) w bazie kodu aplikacji zawiera zaktualizowaną nazwę domyślnego zasobnika Cloud Storage.Pobrany plik konfiguracji zastąpi istniejący plik
google-services.json
w katalogu modułu aplikacji (na poziomie aplikacji).Upewnij się, że w aplikacji masz tylko ostatnio pobrany plik konfiguracji i że jego nazwa nie zawiera dodatkowych znaków, np.
(2)
.
Uzyskaj dostęp do zasobnika Cloud Storage, tworząc instancję
FirebaseStorage
:Kotlin+KTX
storage = Firebase.storage
// Alternatively, explicitly specify the bucket name URL. // val storage = Firebase.storage("gs://BUCKET_NAME")
Java
FirebaseStorage storage = FirebaseStorage.getInstance();
// Alternatively, explicitly specify the bucket name URL. // FirebaseStorage storage = FirebaseStorage.getInstance("gs://BUCKET_NAME");
Możesz już zacząć używać Cloud Storage.
Co dalej? Dowiedz się, jak utworzyć odwołanie do Cloud Storage.
Konfiguracja zaawansowana
Niektóre przypadki użycia wymagają dodatkowej konfiguracji:
- Używanie zbiorników Cloud Storage w wielu regionach geograficznych
- Korzystanie z Cloud Storage zasobników w różnych klasach pamięci
- Korzystanie z grup Cloud Storage z większą liczbą uwierzytelnionych użytkowników 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ć zasobnik wieloregionalny 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 przypadkach użyj 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 zalogowanie się na kilka kont (np. na konto osobiste i służbowe). Możesz użyć niestandardowej aplikacji Firebase, aby uwierzytelniać każde dodatkowe konto.
Używanie wielu grup Cloud Storage
Jeśli chcesz użyć zasobnika Cloud Storage innego niż domyślny opisany wcześniej w tym przewodniku lub użyć kilku zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję FirebaseStorage
, która odwołuje się do niestandardowego zasobnika:
Kotlin+KTX
// Get a non-default Storage bucket val storage = Firebase.storage("gs://my-custom-bucket")
Java
// Get a non-default Storage bucket FirebaseStorage storage = FirebaseStorage.getInstance("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 jest częścią pakietu SDK Google Cloud:
gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME
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 i w przyszłości będzie realizowany 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:
Kotlin+KTX
// Get the default bucket from a custom FirebaseApp val storage = Firebase.storage(customApp!!) // Get a non-default bucket from a custom FirebaseApp val customStorage = Firebase.storage(customApp, "gs://my-custom-bucket")
Java
// Get the default bucket from a custom FirebaseApp FirebaseStorage storage = FirebaseStorage.getInstance(customApp); // Get a non-default bucket from a custom FirebaseApp FirebaseStorage customStorage = FirebaseStorage.getInstance(customApp, "gs://my-custom-bucket");
Dalsze kroki
Przygotuj się do uruchomienia aplikacji:
Włącz App Check, aby mieć pewność, że tylko Twoje aplikacje będą miały dostęp do zasobników na dane.
W konsoli Google Cloud skonfiguruj alerty dotyczące budżetu dla projektu.
Aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase, monitoruj panel Dane i rozliczenia w konsoli Firebase. Więcej szczegółowych informacji o wykorzystaniu znajdziesz też w Cloud Storagepanelu.
Zapoznaj się z listą kontrolną przed wdrożeniem Firebase.