Zacznij korzystać z Cloud Storage na Androidzie

Cloud Storage dla Firebase umożliwia przesyłanie i udostępnianie treści generowanych przez 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 obiektowego przechowywania danych o skali eksabajtów, charakteryzującym się wysoką dostępnością i globalną redundancją. Cloud Storage dla Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, z łatwością obsługując niestabilne sieci.

Warunki wstępne

Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu na Androida .

Utwórz domyślny zasobnik Cloud Storage

  1. W panelu nawigacyjnym konsoli Firebase wybierz opcję Pamięć , a następnie kliknij Rozpocznij .

  2. Przejrzyj wiadomości dotyczące zabezpieczania danych w Cloud Storage za pomocą reguł bezpieczeństwa. Podczas opracowywania rozważ ustawienie reguł dostępu publicznego .

  3. Wybierz lokalizację domyślnego zasobnika Cloud Storage.

    • To ustawienie lokalizacji jest domyślną lokalizacją zasobu Google Cloud Platform (GCP) Twojego projektu. Pamiętaj, że ta lokalizacja będzie używana w Twoim projekcie dla usług GCP, które wymagają ustawienia lokalizacji, w szczególności bazy danych Cloud Firestore i aplikacji App Engine (która jest wymagana, jeśli korzystasz z Cloud Scheduler).

    • Jeśli nie możesz wybrać lokalizacji, oznacza to, że Twój projekt ma już domyślną lokalizację zasobu GCP. Zostało to ustawione podczas tworzenia projektu lub podczas konfigurowania innej usługi wymagającej ustawienia lokalizacji.

    Jeśli korzystasz z planu Blaze, możesz utworzyć wiele segmentów , każdy z własną lokalizacją .

  4. Kliknij Gotowe .

Skonfiguruj dostęp publiczny

Cloud Storage dla Firebase udostępnia język reguł deklaratywnych, który umożliwia zdefiniowanie struktury danych, sposobu ich indeksowania oraz tego, 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ą czytać i zapisywać dane. Aby rozpocząć bez konfigurowania uwierzytelniania , możesz skonfigurować reguły dostępu publicznego .

Dzięki temu Cloud Storage będzie dostępny dla każdego, nawet dla osób, które nie korzystają z Twojej aplikacji, więc pamiętaj o ponownym ograniczeniu Cloud Storage po skonfigurowaniu uwierzytelniania.

Dodaj pakiet SDK Cloud Storage do swojej 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ść dla Cloud Storage biblioteka dla Androida. Zalecamy używanie Firebase Android BoM do kontrolowania wersji bibliotek.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.6.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")
}

Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze korzystać z kompatybilnych wersji bibliotek Firebase Android.

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

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

Pamiętaj, że jeśli używasz w swojej aplikacji wielu bibliotek Firebase, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co gwarantuje, że wszystkie wersje będą kompatybilne.

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:20.3.0")
}
Szukasz modułu bibliotecznego specyficznego dla Kotlina? Począwszy od października 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i Java mogą polegać na głównym module biblioteki (więcej informacji można znaleźć w często zadawanych pytaniach dotyczących tej inicjatywy ).

Skonfiguruj przechowywanie w chmurze

Pierwszym krokiem w uzyskaniu dostępu do zasobnika Cloud Storage jest utworzenie instancji FirebaseStorage :

Kotlin+KTX

storage = Firebase.storage
StorageActivity.kt

Java

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

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

Najpierw nauczmy się, jak utworzyć odwołanie do Cloud Storage .

Ustawienia zaawansowane

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 nich. Możesz na przykład utworzyć zasobniki w USA, Europie i Azji, aby przechowywać dane dla użytkowników w tych regionach, aby zmniejszyć opóźnienia.

Drugi przypadek użycia jest pomocny, jeśli masz dane o różnych wzorcach dostępu. Na przykład: możesz skonfigurować segment obejmujący wiele regionów lub regionów, w którym będą przechowywane zdjęcia lub inne często odwiedzane treści, oraz segment typu Nearline lub Coldline, w którym będą przechowywane kopie zapasowe użytkowników lub inne rzadko używane treści.

W każdym z tych przypadków będziesz chciał użyć wielu zasobników Cloud Storage .

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która pozwala użytkownikom mieć wiele zalogowanych kont (na przykład konto osobiste i konto służbowe). Możesz użyć niestandardowej instancji aplikacji Firebase, aby uwierzytelnić każde dodatkowe konto.

Korzystaj z wielu zasobników Cloud Storage

Jeśli chcesz używać zasobnika Cloud Storage innego niż domyślny podany powyżej lub korzystać z wielu zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję FirebaseStorage , która odwołuje się do Twojego zasobnika niestandardowego:

Kotlin+KTX

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

Importując istniejący zasobnik 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 service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Numer projektu znajdziesz w sposób opisany we wstępie do projektów Firebase .

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślną kontrolę dostępu ustawioną na zezwalającą Firebase. Jest to rozwiązanie tymczasowe i w przyszłości zostanie wykonane automatycznie.

Użyj niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej skomplikowaną aplikację przy użyciu niestandardowej FirebaseApp , możesz utworzyć instancję FirebaseStorage zainicjowaną za pomocą tej aplikacji:

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

Następne kroki