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 treści multimedialnych w aplikacjach. Twoje dane są przechowywane w zasobniku Google Cloud Storage – rozwiązaniu do przechowywania obiektów w skali eksabajtów o wysokiej dostępności i globalnej nadmiarowości. Cloud Storage for Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, bez problemu radząc sobie z niestabilnymi sieciami.

Zanim zaczniesz

  1. Jeśli jeszcze nie masz za sobą przewodnika dla początkujących po aplikacjach na Androida, zapoznaj się z nim. Obejmuje to m.in.:

    • Tworzenie projektu w Firebase.

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

  2. Upewnij się, że Twój projekt w Firebase jest objęty abonamentem Blaze z płatnością według wykorzystania, który jest wymagany do korzystania z Cloud Storage for Firebase. Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy kwalifikujesz się do otrzymania 300 USD środków.

Tworzenie domyślnego zasobnika Cloud Storage

  1. W konsoli Firebase kliknij Bazy danych i miejsce na dane > Miejsce na dane.

    Jeśli Twój projekt nie jest jeszcze objęty abonamentem Blaze z płatnością według wykorzystania, pojawi się prośba o jego uaktualnienie.

  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.

Możesz teraz wyświetlić zasobnik w konsoli Firebase (otwórz kartę Databases & Storage > Storage > Files). Domyślny format nazwy zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia deklaratywny język reguł, który pozwala określić, jak dane mają być ustrukturyzowane i indeksowane oraz kiedy można je 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ąć bez konfigurowania Authentication, możesz skonfigurować reguły dostępu publicznego.

Dzięki temu Cloud Storage będzie otwarty dla wszystkich, nawet dla osób, które nie korzystają z Twojej aplikacji, więc pamiętaj, aby ponownie ograniczyć Cloud Storage po skonfigurowaniu uwierzytelniania.

Dodaj pakiet 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ść z biblioteką Cloud Storage na Androida. Zalecamy używanie Firebase Android BoM do kontrolowania obsługi wersji biblioteki. 

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

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

(Alternatywa)  Dodaj zależności biblioteki Firebase bez używania BoM

Jeśli nie zdecydujesz się na użycie Firebase BoM, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.

Jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek, co zapewni 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:23.0.0")
}

Konfigurowanie Cloud Storage w aplikacji

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

    1. Pobierz zaktualizowany plik konfiguracji.

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

      Upewnij się, że w aplikacji masz tylko ten ostatnio 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
     
    // Alternatively, explicitly specify the bucket name URL.
// val storage = Firebase.storage("gs://BUCKET_NAME")

    Java 

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

Możesz już zacząć korzystać z usługi Cloud Storage.

Co dalej? Dowiedz się, jak utworzyć plik referencyjny 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 blisko nich. 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óźnienia.

Drugi przypadek użycia jest przydatny, jeśli masz dane o różnych wzorcach dostępu. Możesz na przykład skonfigurować zasobnik w wielu regionach lub w jednym regionie, 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ć 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 kilka kont (np. konto osobiste i konto służbowe). Możesz użyć niestandardowej instancji aplikacji w Firebase, aby uwierzytelnić każde konto dodatkowe.

Używanie wielu zasobników Cloud Storage

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

Kotlin 

// 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 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ą 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 zgodnie z opisem we wprowadzeniu do projektów w Firebase.

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

Używanie niestandardowej aplikacji w Firebase

Jeśli tworzysz bardziej skomplikowaną aplikację przy użyciu niestandardowego elementu 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")

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