Cloud Storage dla Firebase umożliwia przesyłanie i udostępnianie treści tworzonych przez użytkowników, takich jak obrazy i wideo, co pozwala na wbudowanie treści multimedialnych do aplikacji. Twoje dane są przechowywane w zasobniku Google Cloud Storage — rozwiązaniu obiektowej pamięci masowej 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 nieregularne sieci.
Wymagania wstępne
- Zainstaluj pakiet SDK Firebase .
- Dodaj swoją aplikację do projektu Firebase w konsoli Firebase .
Utwórz domyślny zasobnik Cloud Storage
W panelu nawigacyjnym konsoli Firebase wybierz Pamięć , a następnie kliknij Rozpocznij .
Zapoznaj się z komunikatem dotyczącym zabezpieczania danych Cloud Storage przy użyciu reguł bezpieczeństwa. Podczas opracowywania rozważ skonfigurowanie reguł publicznego dostępu .
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 usługach GCP w Twoim projekcie, które wymagają ustawienia lokalizacji, w szczególności w bazie danych Cloud Firestore i aplikacji App Engine (która jest wymagana, jeśli korzystasz z Cloud Scheduler).
Jeśli nie możesz wybrać lokalizacji, Twój projekt ma już domyślną lokalizację zasobów GCP. Została ustawiona podczas tworzenia projektu lub podczas konfigurowania innej usługi, która wymaga ustawienia lokalizacji.
Jeśli korzystasz z planu Blaze, możesz utworzyć wiele zasobników , każdy z własną lokalizacją .
Kliknij Gotowe .
Skonfiguruj dostęp publiczny
Cloud Storage for Firebase udostępnia język reguł deklaratywnych, który pozwala określić strukturę danych, sposób ich indeksowania oraz kiedy dane mogą być odczytywane i zapisywane. 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 uwierzytelniania , możesz skonfigurować reguły dostępu publicznego .
To sprawia, że Cloud Storage jest otwarty dla każdego, nawet dla osób, które nie korzystają z Twojej aplikacji, więc pamiętaj o ponownym ograniczeniu Cloud Storage podczas konfigurowania uwierzytelniania.
Dodaj Cloud Storage do swojej aplikacji
Użyj Menedżera pakietów Swift, aby zainstalować i zarządzać zależnościami Firebase.
- W Xcode przy otwartym projekcie aplikacji przejdź do File > Add Packages .
- Po wyświetleniu monitu dodaj repozytorium Firebase Apple platforms SDK:
- Wybierz bibliotekę Cloud Storage.
- Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie zależności w tle.
https://github.com/firebase/firebase-ios-sdk
Skonfiguruj przechowywanie w chmurze
Musisz zainicjować Firebase, zanim zostanie utworzone lub użyte jakiekolwiek odwołanie do Firebase. Jeśli zrobiłeś to już dla innej funkcji Firebase, możesz pominąć ten krok.
- Zaimportuj moduł
FirebaseCore
do swojegoUIApplicationDelegate
, a także wszelkie inne moduły Firebase, z których korzysta delegat aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Szybki
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Cel C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Skonfiguruj udostępnioną instancję
FirebaseApp
w metodzie applicationapplication(_:didFinishLaunchingWithOptions:)
delegata aplikacji:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Szybki
// Use Firebase library to configure APIs FirebaseApp.configure()
Cel C
// Use Firebase library to configure APIs [FIRApp configure];
- Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć go do struktury
App
za pośrednictwemUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
. Musisz także wyłączyć przełączanie delegatów aplikacji. Aby uzyskać więcej informacji, zobacz instrukcje SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Uzyskaj odniesienie do usługi Cloud Storage, korzystając z domyślnej aplikacji Firebase:
Szybki
let storage = Storage.storage()
Cel C
FIRStorage *storage = [FIRStorage storage];
Możesz zacząć korzystać z Cloud Storage!
Najpierw nauczmy się, jak utworzyć plik referencyjny Cloud Storage .
Ustawienia zaawansowane
Istnieje kilka przypadków użycia, które wymagają dodatkowej konfiguracji:
- Korzystanie z zasobników Cloud Storage w wielu regionach geograficznych
- Korzystanie z zasobników Cloud Storage w różnych klasach pamięci
- Korzystanie z 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 ich pobliżu. Na przykład możesz tworzyć zasobniki w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników w tych regionach, aby zmniejszyć opóźnienia.
Drugi przypadek użycia jest przydatny, jeśli masz dane o różnych wzorcach dostępu. Na przykład: możesz skonfigurować wieloregionalny lub regionalny zasobnik, w którym są przechowywane obrazy lub inne często używane treści, oraz zasobnik typu nearline lub coldline, w którym są 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 do uwierzytelnienia każdego dodatkowego konta.
Używaj wielu zasobników Cloud Storage
Jeśli chcesz używać zasobnika Cloud Storage innego niż domyślny podany powyżej lub używać wielu zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję FIRStorage
, która odwołuje się do zasobnika niestandardowego:
Szybki
// Get a non-default Cloud Storage bucket storage = Storage.storage(url:"gs://my-custom-bucket")
Cel C
// Get a non-default Cloud Storage bucket FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
Praca z importowanymi zasobnikami
Podczas importowania istniejącego zasobnika Cloud Storage do Firebase musisz zezwolić Firebase na dostęp 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 zezwalanie na Firebase. Jest to środek tymczasowy i zostanie wykonany automatycznie w przyszłości.
Użyj niestandardowej aplikacji Firebase
Jeśli tworzysz bardziej skomplikowaną aplikację przy użyciu niestandardowej FirebaseApp
, możesz utworzyć instancję Storage
zainicjowaną z tą aplikacją:
Szybki
// Get the default bucket from a custom FirebaseApp storage = Storage.storage(app:customApp) // Get a non-default bucket from a custom FirebaseApp storage = Storage.storage(app:customApp, url:"gs://my-custom-bucket")
Cel C
// Get the default bucket from a custom FIRApp FIRStorage storage = [FIRStorage storageForApp:customApp]; // Get a non-default bucket from a custom FIRApp FIRStorage storage = [FIRStorage storageForApp:customApp withURL:@"gs://my-custom-bucket"];
Następne kroki
Przygotuj się do uruchomienia aplikacji:
Włącz sprawdzanie aplikacji , aby mieć pewność, że tylko Twoje aplikacje będą miały dostęp do zasobników na dane.
Skonfiguruj alerty budżetowe dla swojego projektu w Google Cloud Console.
Monitoruj pulpit nawigacyjny Wykorzystanie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase. Możesz także odwiedzić pulpit nawigacyjny Cloud Storage Usage , aby uzyskać bardziej szczegółowe informacje o użytkowaniu.
Przejrzyj listę kontrolną uruchamiania Firebase .