Cloud Storage dla Firebase umożliwia przesyłanie i udostępnianie treści użytkowników, takich jak w postaci obrazów i filmów, co umożliwia umieszczanie w witrynie treści multimedialnych aplikacji. Twoje dane są przechowywane w Zasobnik Google Cloud Storage – rozwiązanie do przechowywania obiektów w skali eksabajtów z wysoką dostępnością i globalną nadmiarowość. Cloud Storage dla Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek, co pozwala na obsługę niestabilnych sieci łatwość użycia.
Wymagania wstępne
Jeśli jeszcze nie masz tego za sobą, dodaj Firebase do swojego projektu na Androida.
Tworzenie domyślnego zasobnika Cloud Storage
W panelu nawigacji w konsoli Firebase kliknij Miejsce na dane. i kliknij Rozpocznij.
Przeczytaj komunikaty na temat zabezpieczania danych w Cloud Storage za pomocą zabezpieczeń reguł. Podczas tworzenia projektu warto wziąć pod uwagę konfigurowanie reguł dostępu publicznego.
Wybierz lokalizację domyślną. Zasobnik Cloud Storage.
To ustawienie lokalizacji jest powiązane z ustawieniami domyślna lokalizacja zasobów Google Cloud Platform (GCP). Pamiętaj, że ta lokalizacja będzie używana w przypadku usług GCP w Twoim projekcie które wymagają ustawienia lokalizacji, Baza danych Cloud Firestore oraz Aplikacja App Engine (wymagane w przypadku korzystania z usługi Cloud Scheduler).
Jeśli nie możesz wybrać lokalizacji, oznacza to, że Twój projekt już tam jest. ma domyślną lokalizację zasobów GCP. Został ustawiony podczas projektu lub podczas konfigurowania innej usługi, która wymaga podania lokalizacji. .
Jeśli masz abonament Blaze, utworzyć wiele zasobników, każdy z własnym lokalizacja.
Kliknij Gotowe.
Konfigurowanie dostępu publicznego
Cloud Storage dla Firebase udostępnia język reguł deklaratywnych, który pozwala aby zdefiniować, jak powinny wyglądać dane strukturalne, jak powinny być indeksowane i kiedy gdzie dane mogą być odczytywane i zapisywane. Domyślnie uprawnienia do odczytu i zapisu w Usługa Cloud Storage jest ograniczona, więc tylko uwierzytelnieni użytkownicy mogą odczytywać i zapisywać dane i skalowalnych danych. Aby rozpocząć bez konfigurowania uwierzytelniania, możesz: skonfigurować reguły dostępu publicznego.
Dzięki temu usługa Cloud Storage jest dostępna dla każdego, nawet dla osób, które nie korzystają więc ponownie ogranicz dostęp do Cloud Storage, uwierzytelnianie.
Dodawanie pakietu SDK Cloud Storage do aplikacji
w pliku Gradle (na poziomie aplikacji) modułu, (zwykle<project>/<app-module>/build.gradle.kts lub
<project>/<app-module>/build.gradle),
dodaj zależność z biblioteką Cloud Storage na Androida. Zalecamy użycie metody
Funkcja BoM Firebase na Androida
aby kontrolować obsługę wersji biblioteki.
dependencies {
// Import the BoM for the Firebase platform
implementation(platform("com.google.firebase:firebase-bom:33.1.2"))
// 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")
}
Korzystając z BM Firebase Android BoM, Twoja aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.
(Wersja alternatywna) Dodawanie zależności biblioteki Firebase bez korzystania z BM
Jeśli nie chcesz używać Firebase BoM, musisz określić każdą wersję biblioteki Firebase w wierszu zależności.
Pamiętaj, że jeśli używasz wielu bibliotek Firebase w swojej aplikacji, zalecamy korzystanie z BoM do zarządzania wersjami biblioteki, dzięki czemu wszystkie wersje
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.0")
}
Konfigurowanie Cloud Storage
Pierwszym krokiem do uzyskania dostępu do zasobnika Cloud Storage jest utworzenie
wystąpienie FirebaseStorage:
Kotlin+KTX
storage = Firebase.storage
Java
FirebaseStorage storage = FirebaseStorage.getInstance();
Możesz już zacząć korzystać z Cloud Storage.
Najpierw dowiedzmy się, jak utworzyć Cloud Storage odniesienie.
Konfiguracja zaawansowana
W kilku przypadkach dodatkowa konfiguracja może być wymagana:
- Korzystanie z zasobników Cloud Storage w wiele regionów geograficznych
- Korzystanie z zasobników Cloud Storage w różnych klasach pamięci masowej
- Używanie 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 i przechowywanie danych w pobliżu. Można na przykład utworzyć zasobniki w Stanach Zjednoczonych, w Europie i Azji do przechowywania danych użytkowników w tych regionach, aby zmniejszyć czas oczekiwania.
Drugi przypadek użycia jest przydatny, gdy masz dane o różnych wzorcach dostępu. Możesz na przykład skonfigurować zasobnik dla wielu regionów lub jeden region, w którym będzie przechowywana zdjęcia lub inne często używane treści, a także zbiór zdjęć Nearline lub Coldline, który zawiera kopie zapasowe użytkowników lub inne rzadko używane treści.
W każdym z tych przypadków warto wykonać korzystać z wielu zasobników Cloud Storage.
Trzeci przypadek użycia jest przydatny, gdy tworzysz aplikację, np. Dysk Google, który umożliwia użytkownikom posiadanie wielu kont (na przykład konto osobiste, i konto służbowe). Dostępne opcje za pomocą niestandardowej aplikacji Firebase do uwierzytelniania każdego dodatkowego konta.
Korzystanie z wielu zasobników Cloud Storage
Jeśli chcesz użyć innego zasobnika Cloud Storage niż domyślny zasobnik podany powyżej,
lub korzystasz z wielu zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję
z FirebaseStorage, które odwołuje się do Twojego zasobnika niestandardowego:
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 przyznać Firebase dostęp do tych plików za pomocą
gsutil w narzędziu
Pakiet 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 można znaleźć, tak jak to opisano we wprowadzeniu do Projekty Firebase.
Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślny dostęp aby zezwolić na używanie Firebase. Jest to rozwiązanie tymczasowe i w sposób nie będzie odbywać się automatycznie.
Użyj niestandardowej aplikacji Firebase
Jeśli tworzysz bardziej złożoną aplikację, korzystając z niestandardowego interfejsu FirebaseApp, możesz:
utwórz instancję FirebaseStorage zainicjowaną z tą aplikacją:
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
Przygotowanie do wprowadzenia aplikacji:
Włącz Sprawdzanie aplikacji, by mieć pewność, że tylko aplikacje mogą uzyskać dostęp do zasobników na dane.
Określ budżet alerty swojego projektu w konsoli Google Cloud.
Monitorowanie korzystania i płatności panel w konsoli Firebase, aby uzyskać ogólny obraz i wielu usług Firebase. Możesz też przejść do strony Wykorzystanie Cloud Storage panel, aby dowiedzieć się więcej szczegółowe informacje o korzystaniu.
Zapoznaj się z listą kontrolną uruchamiania Firebase.