Pierwsze kroki z Cloud Storage na urządzeniu z Androidem

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 rich media. Twoje dane są przechowywane w Google Cloud Storage zasobniku – rozwiązaniu do przechowywania obiektów o skali eksabajtów, które charakteryzuje się wysoką dostępnością i globalną redundancją. Cloud Storage for 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 niestabilnymi sieciami.

Zanim zaczniesz

1. Jeśli jeszcze tego nie zrobisz, zapoznaj się z przewodnikiem dla początkujących dotyczącym aplikacji na Androida. Obejmuje on m.in.:

   • Tworzenie projektu w Firebase.

   • Rejestrowanie aplikacji na Androida w projekcie i łączenie aplikacji z Firebase przez dodanie do niej zależności Firebase, wtyczki usług Google oraz pliku konfiguracyjnego Firebase (google-services.json).

2. Upewnij się, że Twój projekt w Firebase korzysta z abonamentu Blaze z płatnością według wykorzystania. Jest to wymaganie, które zaczęło obowiązywać w październiku 2024 r. (zobacz Najczęstsze pytania). Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy kwalifikujesz się do otrzymania kredytu w wysokości 300 USD.

Tworzenie domyślnego zasobnikaCloud Storage

1. W panelu nawigacyjnym konsoli Firebase wybierz Przechowywanie danych.

   Jeśli Twój projekt nie korzysta jeszcze z abonamentu Blaze z płatnością według wykorzystania, pojawi się prośba o przejście na większy pakiet.

2. Kliknij Rozpocznij.

3. Wybierz lokalizację domyślnego zasobnika.

   • Zasobniki w lokalizacjach US-CENTRAL1, US-EAST1 i US-WEST1 mogą korzystać z bezpłatnego poziomu dla Google Cloud Storage. W przypadku zasobników w innych lokalizacjach obowiązują Google Cloud Storage ceny i zasady użytkowania.

   • Jeśli chcesz, możesz później utworzyć kilka zasobników, z których każdy będzie miał własną lokalizację.

4. Skonfiguruj Firebase Security Rules dla domyślnego zasobnika. Podczas programowania, rozważ skonfigurowanie reguł dostępu publicznego.

5. Kliknij Gotowe.

Teraz możesz wyświetlić zasobnik na karcie Cloud Storage Pliki konsoli.Firebase Format nazwy domyślnego zasobnika to PROJECT_ID.firebasestorage.app.

Uwaga: od 30 października 2024 r. wszystkie nowe domyślne Cloud Storage zasobniki mają format nazwy PROJECT_ID.firebasestorage.app. Wszystkie domyślne zasobniki utworzone przed tą datą mają format nazwy PROJECT_ID.appspot.com. Więcej informacji znajdziesz w najczęstszych pytaniach.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia deklaratywny język reguł, który umożliwia określenie struktury danych, sposobu ich indeksowania oraz tego, kiedy dane można 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ąć korzystanie z Cloud Storage bez konfigurowania Authentication, możesz skonfigurować reguły dostępu publicznego.

Spowoduje to, że Cloud Storage będzie otwarty 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 pakiamu SDK Cloud Storage do aplikacji

W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle), dodaj zależność od biblioteki Cloud Storage na Androida. Do kontrolowania obsługi wersji biblioteki zalecamy używanie Firebase Android BoM.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.11.0"))

    // 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")
}

Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

(Alternatywnie)  Dodawanie zależności biblioteki Firebase bez używania BoM

Jeśli nie chcesz używać Firebase BoM, musisz określić wersję każdej biblioteki Firebase w wierszu zależności.

Pamiętaj, że jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co zapewnia ich zgodność.

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:22.0.1")
}

Konfigurowanie Cloud Storage w aplikacji

1. Upewnij się, że plik konfiguracyjny Firebase (google-services.json) w bazie kodu aplikacji jest zaktualizowany o nazwę domyślnego zasobnika Cloud Storage.

   1. Pobierz zaktualizowany plik konfiguracyjny..

   2. Użyj pobranego pliku konfiguracyjnego, aby zastąpić istniejący plik google-services.json w katalogu modułu aplikacji (na poziomie aplikacji).

      Upewnij się, że w aplikacji masz tylko ten najnowszy pobrany plik konfiguracyjny i że jego nazwa nie zawiera dodatkowych znaków, np. (2).

   Uwaga: zamiast zastępować plik konfiguracyjny, możesz wyraźnie określić nazwę zasobnika podczas tworzenia instancji FirebaseStorage (patrz następny krok). Nazwę zasobnika znajdziesz na karcie Cloud Storage Pliki w konsoli.
   Firebase

2. Uzyskaj dostęp do zasobnika Cloud Storage, tworząc instancję FirebaseStorage:

   Kotlin

   storage = Firebase.storage
   StorageActivity.kt

   // Alternatively, explicitly specify the bucket name URL.
   // val storage = Firebase.storage("gs://BUCKET_NAME")

   Java

   FirebaseStorage storage = FirebaseStorage.getInstance();
   StorageActivity.java

   // Alternatively, explicitly specify the bucket name URL.
   // FirebaseStorage storage = FirebaseStorage.getInstance("gs://BUCKET_NAME");

Możesz już zacząć korzystać z Cloud Storage!

Następny krok? Dowiedz się, jak utworzyć odwołanie.Cloud Storage

Konfiguracja zaawansowana

W kilku przypadkach użycia wymagana jest dodatkowa konfiguracja:

• Korzystanie z Cloud Storage zasobników w wielu regionach geograficznych
• Korzystanie z Cloud Storage zasobników 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 pobliżu. 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óźnienie.

Drugi przypadek użycia jest przydatny, jeśli masz dane o różnych wzorcach dostępu. Możesz na przykład skonfigurować zasobnik wieloregionowy 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 tych przypadkach użycia warto korzystać z kilku Cloud Storage zasobników.

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). Do uwierzytelniania każdego dodatkowego konta możesz użyć niestandardowej instancji aplikacji Firebase.

Korzystanie z kilku zasobników Cloud Storage

Jeśli chcesz używać zasobnika Cloud Storage innego niż domyślny zasobnik opisany wcześniej w tym przewodniku lub używać kilku zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję FirebaseStorage, która odwołuje się do Twojego niestandardowego zasobnika:

Kotlin

// Get a non-default Storage bucket
val storage = Firebase.storage("gs://my-custom-bucket")
StorageActivity.kt

Java

// Get a non-default Storage bucket
FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
StorageActivity.java

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 zawartego w pakiecie Google Cloud SDK:

gsutil -m acl ch -r -u [e-mail] gs://BUCKET_NAME

Numer projektu znajdziesz w sekcji Wprowadzenie do projektów Firebase.

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślną kontrolę dostępu ustawioną na zezwalanie Firebase. Jest to środek tymczasowy, który w przyszłości będzie wykonywany automatycznie.

Używanie niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej złożoną aplikację za pomocą niestandardowej aplikacji FirebaseApp, możesz utworzyć instancję FirebaseStorage zainicjowaną za pomocą tej aplikacji:

Kotlin

// 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")
StorageActivity.kt

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");
StorageActivity.java

Dalsze kroki

• Przygotuj się do opublikowania aplikacji:

  • Włącz funkcję App Check, aby mieć pewność, że tylko Twoje aplikacje mogą uzyskiwać dostęp do zasobników.

  • Skonfiguruj budżet alertów dla swojego projektu w Google Cloud konsoli.

  • Monitoruj panel Użycie i płatności w konsoli Firebase aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase. Aby uzyskać bardziej szczegółowe informacje o wykorzystaniu, możesz też otworzyć panel Cloud Storage Użycie dashboard w Cloud Storage.

  • Zapoznaj się z listą kontrolną przed opublikowaniem aplikacji Firebase.