Pierwsze kroki z Cloud Storage na urządzeniu z Androidem

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści 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 tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, a także bezproblemowe radzenie sobie z niestabilnymi sieciami.

Zanim zaczniesz

  1. Jeśli jeszcze tego nie zrobisz, zapoznaj się z przewodnikiem rozpoczęcia pracy z aplikacjami 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).

  2. 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 w postaci środków.

Tworzenie domyślnego zasobnika Cloud Storage

  1. 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.

  2. Kliknij Rozpocznij.

  3. Wybierz lokalizację domyślnego zasobnika.

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

  5. Kliknij Gotowe.

Zasobnik możesz teraz wyświetlić na karcie Cloud Storage Pliki w 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 umożliwia określenie, 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 zacząć korzystać z Authentication bez konfigurowania, 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 podczas konfigurowania uwierzytelniania ponownie ograniczyć dostęp do Cloud Storage.

Dodawanie do aplikacji pakietu SDK Cloud Storage

W pliku Gradle 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.13.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 korzystasz z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

(Alternatywnie)  Dodaj zależności biblioteki Firebase bez korzystania z BoM

Jeśli zdecydujesz się nie używać Firebase BoM, musisz podać każdą wersję biblioteki Firebase w linii 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")
}
 Szukasz modułu biblioteki dla Kotlina? Od października 2023 r. (Firebase BoM 32.5.0) deweloperzy Kotlina i Java mogą korzystać z głównego modułu biblioteki (szczegółowe informacje znajdziesz w często zadawanych pytaniach dotyczących tej inicjatywy).

Konfigurowanie Cloud Storage w aplikacji

  1. Sprawdź, czy plik konfiguracji Firebase (google-services.json) w bazie kodu aplikacji zawiera zaktualizowaną nazwę domyślnego zasobnika Cloud Storage.

    1. Uzyskaj zaktualizowany plik konfiguracji.

    2. Pobrany plik konfiguracji zastąpi istniejący plik google-services.json w katalogu modułu aplikacji (na poziomie aplikacji).

      Upewnij się, że w aplikacji jest tylko ostatnio pobrany plik konfiguracji i że jego nazwa nie zawiera dodatkowych znaków, np. (2).

  2. Aby uzyskać dostęp do zasobnika Cloud Storage, utwórz 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ąć używać Cloud Storage.

Co dalej? Dowiedz się, jak utworzyć odwołanie Cloud Storage.

Konfiguracja zaawansowana

Niektóre przypadki użycia wymagają dodatkowej konfiguracji:

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 wzorcami 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 tych przypadkach warto użyć kilku grup Cloud Storage.

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom logowanie się na wiele 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 

// 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 zaimportowanymi zasobnikami

Podczas importowania istniejącego zasobnika Cloud Storage do Firebase musisz przyznać Firebase uprawnienia dostępu do tych plików za pomocą narzędzia gsutil, które jest częścią pakietu Google Cloud SDK:

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 ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślnie ustawioną kontrolę dostępu, która zezwala na dostęp 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:

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