Pierwsze kroki z Cloud Storage na Androidzie

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 treści multimedialnych w aplikacjach. Twoje dane są przechowywane w Zasobnik Google Cloud Storage – rozwiązanie do przechowywania obiektów w skali eksabajtów z wysoką dostępnością i globalną nadmiarowość. 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 sprawne działanie w przypadku niestabilnych sieci.

Wymagania wstępne

Jeśli jeszcze nie masz tego za sobą, dodaj Firebase do swojego projektu na Androida.

Utwórz domyślny zasobnik Cloud Storage

1. W panelu nawigacji konsoli Firebase wybierz Miejsce na dane. a następnie kliknij Rozpocznij.

2. Zapoznaj się z informacjami na temat zabezpieczania danych Cloud Storage przy użyciu zabezpieczeń reguł. Podczas tworzenia aplikacji rozważ ustawienie reguł dostępu publicznego.

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

   • To ustawienie lokalizacji jest domyślną lokalizacją zasobów Google Cloud Platform (GCP) Twojego projektu. Pamiętaj, że ta lokalizacja będzie używana w przypadku usług GCP w Twoim projekcie które wymagają ustawienia lokalizacji, Cloud Firestore Aplikacja App Engine (wymagane, jeśli używasz Cloud Scheduler).

   • Jeśli nie możesz wybrać lokalizacji, oznacza to, że Twój projekt już tam jest. ma domyślną lokalizację zasobów GCP. Został ustawiony podczas projektu lub podczas konfigurowania innej usługi, która wymaga podania lokalizacji. .

   Jeśli korzystasz z abonamentu Blaze, możesz utworzyć wiele zasobników, z których każdy będzie mieć swoją własną lokalizację.

4. Kliknij Gotowe.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia język reguł deklaratywnych, który pozwala aby zdefiniować, jak powinny wyglądać dane strukturalne, jak powinny być indeksowane i kiedy gdzie dane mogą być odczytywane i zapisywane. Domyślnie dostęp do odczytu i zapisu w folderze 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 po skonfigurowaniu uwierzytelniania ponownie ograniczyć dostęp do Cloud Storage.

Dodaj do aplikacji pakiet SDK Cloud Storage

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

Dzięki użyciu Firebase Android BoMaplikacja zawsze będzie używać zgodnych wersji bibliotek Firebase na Androida.

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

Skonfiguruj usługę Cloud Storage

Aby uzyskać dostęp do zasobnika Cloud Storage, musisz najpierw utworzyć instancję FirebaseStorage:

storage = Firebase.storage
StorageActivity.kt

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

Możesz już korzystać z Cloud Storage.

Najpierw dowiedzmy się, jak utworzyć Cloud Storage referencyjnym.

Konfiguracja zaawansowana

W kilku przypadkach dodatkowa konfiguracja może być wymagana:

• Używanie zbiorników Cloud Storage w wielu regionach geograficznych
• Korzystanie z Cloud Storage zasobników w różnych klasach pamięci
• Użycie 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żna na przykład utworzyć zasobniki w Stanach Zjednoczonych, w Europie i Azji do przechowywania danych użytkowników w tych regionach, aby zmniejszyć czas oczekiwania.

Drugi przypadek użycia jest przydatny, jeśli masz dane z różnymi wzorami 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 przypadkach użyj kilku zasobników Cloud Storage.

Trzeci przypadek użycia jest przydatny, gdy tworzysz aplikację, np. Dysk Google, który umożliwia użytkownikom posiadanie wielu kont (na przykład konto osobiste, i konto służbowe). Dostępne opcje za pomocą niestandardowej aplikacji Firebase do uwierzytelniania każdego dodatkowego konta.

Użyj wielu zasobników Cloud Storage

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

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

// 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://<your-cloud-storage-bucket>

Numer projektu można znaleźć, tak jak to opisano we wprowadzeniu do Projekty Firebase.

Nie dotyczy to nowo utworzonych zasobników, ponieważ mają one domyślnie ustawioną kontrolę dostępu zezwalającą na dostęp do Firebase. Jest to rozwiązanie tymczasowe i w sposób nie będzie odbywać się automatycznie.

Użyj 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:

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

// 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 uruchomienia aplikacji:

  • Włącz App Check, aby mieć pewność, że tylko Twoje aplikacje będą miały dostęp do zasobników na dane.

  • W konsoli Google Cloud skonfiguruj alerty dotyczące budżetu dla projektu.

  • Aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase, monitoruj panel Dane i rozliczenia w konsoli Firebase. Więcej szczegółowych informacji o wykorzystaniu znajdziesz też w Cloud Storagepanelu.

  • Przejrzyj listę kontrolną przed wdrożeniem Firebase.