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 zasobniku Google Cloud Storage – rozwiązaniu do przechowywania obiektów o skali eksabajtów, które zapewnia wysoką dostępność 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, z łatwością radząc 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 zależności Firebase, wtyczki usług Google i pliku konfiguracyjnego Firebase (google-services.json) do aplikacji.

  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 konsoli Firebase otwórz Bazy danych i miejsce na dane > Miejsce na dane.

    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 wyższy abonament.

  2. Kliknij Rozpocznij.

  3. Wybierz lokalizację domyślnego zasobnika.

  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 w konsoli Firebase (otwórz kartę Bazy danych i miejsce na dane > Miejsce na dane > Pliki). Format nazwy domyślnego zasobnika to PROJECT_ID.firebasestorage.app.

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 można odczytywać i zapisywać dane. 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.12.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 zgodność wszystkich wersji. 

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

  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

Istnieje kilka przypadków użycia, które 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ć 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 korzystanie z kilku zalogowanych kont (np. konta osobistego i konta służbowego). 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 które jest częścią 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 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