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 treści multimedialnych w aplikacjach. Twoje dane są przechowywane w zasobniku Google Cloud Storage — rozwiązaniu obiektowej pamięci masowej o skali eksabajta o wysokiej dostępności i globalnej nadmiarowości. 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ą obsługując niestabilne sieci.
Warunki wstępne
Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu na Androida .
Utwórz domyślny zasobnik Cloud Storage
W panelu nawigacyjnym konsoli Firebase wybierz Pamięć masowa, a następnie kliknij Rozpocznij .
Zapoznaj się z komunikatem o zabezpieczaniu danych Cloud Storage za pomocą reguł zabezpieczeń. Podczas projektowania rozważ skonfigurowanie reguł publicznego dostępu .
Wybierz lokalizację domyślnego zasobnika Cloud Storage.
To ustawienie lokalizacji to domyślna lokalizacja zasobu Google Cloud Platform (GCP) Twojego projektu . Pamiętaj, że ta lokalizacja będzie używana w usługach GCP w Twoim projekcie, które wymagają ustawienia lokalizacji, w szczególności bazy danych Cloud Firestore i aplikacji App Engine (co jest wymagane, jeśli używasz Cloud Scheduler).
Jeśli nie możesz wybrać lokalizacji, oznacza to, że Twój projekt ma już domyślną lokalizację zasobu GCP. Została ustawiona albo podczas tworzenia projektu, albo podczas konfigurowania innej usługi, która wymaga ustawienia lokalizacji.
Jeśli korzystasz z planu Blaze, możesz utworzyć wiele zasobników , każdy z własną lokalizacją .
Kliknij Gotowe .
Skonfiguruj dostęp publiczny
Cloud Storage dla Firebase udostępnia deklaratywny język reguł, który umożliwia zdefiniowanie struktury danych, sposobu ich indeksowania oraz czasu odczytywania i zapisywania danych. 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 , możesz skonfigurować reguły dostępu publicznego .
Dzięki temu Cloud Storage jest dostępny dla każdego, nawet dla osób, które nie korzystają z Twojej aplikacji, więc pamiętaj o ponownym ograniczeniu Cloud Storage podczas konfigurowania uwierzytelniania.
Dodaj pakiet SDK Cloud Storage do swojej aplikacji
Korzystając z Firebase Android BoM , zadeklaruj zależność dla biblioteki Cloud Storage Android w pliku Gradle modułu (na poziomie aplikacji) (zwykleapp/build.gradle
). Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.3.1') // Declare 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' }
Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase Android.
(Alternatywnie) Zadeklaruj zależności biblioteki Firebase bez użycia BoM
Jeśli zdecydujesz się nie korzystać z BoM Firebase, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.
Pamiętaj, że jeśli korzystasz z wielu bibliotek Firebase w swojej aplikacji, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co zapewnia zgodność wszystkich wersji.
dependencies { // Declare 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:20.0.1' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.3.1') // Declare 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-ktx' }
Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase Android.
(Alternatywnie) Zadeklaruj zależności biblioteki Firebase bez użycia BoM
Jeśli zdecydujesz się nie korzystać z BoM Firebase, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.
Pamiętaj, że jeśli korzystasz z wielu bibliotek Firebase w swojej aplikacji, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co zapewnia zgodność wszystkich wersji.
dependencies { // Declare 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-ktx:20.0.1' }
Skonfiguruj przechowywanie w chmurze
Pierwszym krokiem do uzyskania dostępu do zasobnika Cloud Storage jest utworzenie instancji FirebaseStorage
:
Java
FirebaseStorage storage = FirebaseStorage.getInstance();
Kotlin+KTX
storage = Firebase.storage
Możesz zacząć korzystać z Cloud Storage!
Najpierw nauczmy się, jak utworzyć odniesienie do Cloud Storage .
Ustawienia zaawansowane
Istnieje kilka przypadków użycia, które wymagają dodatkowej konfiguracji:
- Korzystanie z zasobników Cloud Storage w wielu regionach geograficznych
- Korzystanie z zasobników Cloud Storage w różnych klasach pamięci
- 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 ich pobliżu. Możesz na przykład utworzyć zasobniki w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników w tych regionach, aby skrócić czas oczekiwania.
Drugi przypadek użycia jest pomocny, jeśli masz dane o różnych wzorcach dostępu. Na przykład: możesz skonfigurować wieloregionalny lub regionalny zasobnik, który przechowuje zdjęcia lub inną często dostępną zawartość, oraz zasobnik nearline lub coldline, który przechowuje kopie zapasowe użytkowników lub inne rzadko używane treści.
W każdym z tych przypadków użyj 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 wiele kont (na przykład konto osobiste i konto służbowe). Do uwierzytelnienia każdego dodatkowego konta możesz użyć niestandardowej instancji aplikacji Firebase .
Użyj 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ę FirebaseStorage
, która odwołuje się do zasobnika niestandardowego:
Java
// Get a non-default Storage bucket FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
Kotlin+KTX
// Get a non-default Storage bucket val storage = Firebase.storage("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ą narzędzia gsutil
, które znajduje się 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 swojego projektu znajdziesz zgodnie z opisem we wprowadzeniu do projektów Firebase .
Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślną kontrolę dostępu, która zezwala na Firebase. Jest to środek tymczasowy i będzie wykonywany automatycznie w przyszłości.
Użyj niestandardowej aplikacji Firebase
Jeśli tworzysz bardziej skomplikowaną aplikację przy użyciu niestandardowej FirebaseApp
, możesz utworzyć wystąpienie FirebaseStorage
zainicjowane za pomocą tej aplikacji:
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");
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")
Następne kroki
Przygotuj się do uruchomienia aplikacji:
Włącz Sprawdzanie aplikacji , aby upewnić się, że tylko Twoje aplikacje mają dostęp do zasobników na dane.
Skonfiguruj alerty budżetowe dla swojego projektu w Google Cloud Console.
Monitoruj panel użycia i rozliczeń w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase. Możesz również odwiedzić pulpit nawigacyjny Cloud Storage Usage , aby uzyskać bardziej szczegółowe informacje o użytkowaniu.
Przejrzyj listę kontrolną uruchamiania Firebase .