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 zasobniku Google Cloud Storage – rozwiązaniu do przechowywania obiektów o rozmiarze exabajtów z wysoką dostępnością 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, a także bezproblemowe radzenie sobie z niestabilnymi sieciami.
Zanim zaczniesz
Jeśli jeszcze tego nie zrobisz, zapoznaj się z przewodnikiem wprowadzającym na temat aplikacji na platformy Apple. Obejmuje to m.in.:
Tworzenie projektu Firebase.
Zarejestruj aplikację na platformy Apple w projekcie i połącz ją z Firebase, dodając do niej bibliotekę Firebase i plik konfiguracji Firebase (
GoogleService-Info.plist
).
Upewnij się, że Twój projekt Firebase jest objęty abonamentem Blaze (płatność według zużycia zasobów). Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy kwalifikujesz się do otrzymania 300 USD w postaci środków.
Tworzenie domyślnego zasobnika Cloud Storage
W panelu nawigacyjnym konsoli Firebase wybierz Przechowywanie danych.
Jeśli Twój projekt nie jest jeszcze objęty cennikiem Blaze, pojawi się prośba o zaktualizowanie projektu.
Kliknij Rozpocznij.
Wybierz lokalizację domyślnego zasobnika.
Grupy w poziomie
,US-CENTRAL1
iUS-EAST1
mogą korzystać z poziomu „Zawsze bezpłatnie” w usłudze Google Cloud Storage. Segmenty w pozostałych lokalizacjach mają ceny i użycie zgodne z Google Cloud Storage.US-WEST1
Jeśli chcesz, możesz później utworzyć kilka puli, z których każda będzie mieć swoją lokalizację.
Skonfiguruj Firebase Security Rules dla domyślnego zasobnika. Podczas tworzenia aplikacji rozważ ustawienie reguł dotyczących dostępu publicznego.
Kliknij Gotowe.
Zasobnik możesz teraz wyświetlić na karcie Cloud Storage Pliki konsoli Firebase. Domyślny format nazwy zasobnika to PROJECT_ID.firebasestorage.app
Konfigurowanie dostępu publicznego
Cloud Storage for Firebase udostępnia język deklaratywny, który pozwala zdefiniować, jak dane powinny być ustrukturyzowane, jak powinny być indeksowane oraz kiedy można je odczytywać i zapisywać. 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.
Dodawanie Cloud Storage do aplikacji
Do instalacji zależności Firebase i zarządzania nimi możesz używać menedżera pakietów Swift.
- Po otwarciu projektu aplikacji w Xcode wybierz Plik > Dodaj pakiety.
- Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:
- Wybierz bibliotekę Cloud Storage.
- Dodaj flagę
-ObjC
do sekcji Inne flagi linkera w ustawieniach kompilacji docelowej. - Gdy to zrobisz, Xcode automatycznie zacznie wyszukiwać i pobierać zależności w tle.
https://github.com/firebase/firebase-ios-sdk.git
Konfigurowanie Cloud Storage w aplikacji
Zainicjuj Firebase przed utworzeniem lub użyciem dowolnego odwołania do Firebase.
Być może już to zrobiono, jeśli masz już skonfigurowane inne usługi Firebase, ale musisz dodać bibliotekę
FirebaseStorage
do listy importowanych bibliotek.Zaimportuj moduł
FirebaseCore
i modułFirebaseStorage
doUIApplicationDelegate
. Zalecamy też dodanieFirebaseAuth
.SwiftUI
import SwiftUI import FirebaseCore import FirebaseStorage import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseStorage import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseStorage; @import FirebaseAuth; // ...
Skonfiguruj współdzieloną instancję
FirebaseApp
w metodzieapplication(_:didFinishLaunchingWithOptions:)
w delegacie aplikacji:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
(Tylko SwiftUI) Utwórz delegata aplikacji i dołącz go do struktury
App
za pomocąUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
. Musisz też wyłączyć swizyflowanie w aplikacji. Więcej informacji znajdziesz w instrukcjach 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 odwołanie do usługi Cloud Storage, korzystając z domyślnej aplikacji Firebase.
Sprawdź, czy plik konfiguracji Firebase (
GoogleService-Info.plist
) w kodzie źródłowym aplikacji zawiera zaktualizowaną nazwę domyślnego zasobnika Cloud Storage.Pobrany plik konfiguracji zastąpi istniejący plik
GoogleService-Info.plist
w katalogu głównym projektu Xcode. Jeśli pojawi się taka prośba, wybierz opcję dodania pliku konfiguracyjnego do wszystkich miejsc docelowych.Upewnij się, że w aplikacji jest tylko ostatnio pobrany plik konfiguracji i że jego nazwa nie zawiera dodatkowych znaków, np.
(2)
.
Uzyskaj odwołanie do usługi Cloud Storage za pomocą domyślnej aplikacji Firebase:
Swift
let storage = Storage.storage()
// Alternatively, explicitly specify the bucket name URL. storage = Storage.storage(url:"gs://BUCKET_NAME")
Objective-C
FIRStorage *storage = [FIRStorage storage];
// Alternatively, explicitly specify the bucket name URL. // FIRStorage storage = [FIRStorage storageWithURL:@"gs://BUCKET_NAME"];
Możesz już zacząć używać Cloud Storage.
Co dalej? Dowiedz się, jak utworzyć odwołanie Cloud Storage.
Konfiguracja zaawansowana
Niektóre przypadki użycia wymagają dodatkowej konfiguracji:
- Używanie zbiorników Cloud Storage w wielu regionach geograficznych
- Korzystanie z zasobników Cloud Storage w różnych klasach pamięci
- Używanie zbioró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żesz na przykład utworzyć zbiory w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników z tych regionów i w ten sposób zmniejszyć opóźnienia.
Drugi przypadek użycia jest przydatny, jeśli masz dane z różnymi wzorcami 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, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom logowanie się na wiele kont (np. na konto osobiste i służbowe). Aby uwierzytelniać każde dodatkowe konto, możesz użyć niestandardowej aplikacji Firebase.
Używanie wielu grup Cloud Storage
Jeśli chcesz użyć zasobnika Cloud Storage innego niż domyślny podany powyżej lub użyć kilku zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję FIRStorage
, która odwołuje się do zasobu niestandardowego:
Swift
// Get a non-default Cloud Storage bucket
storage = Storage.storage(url:"gs://my-custom-bucket")
Objective-C
// Get a non-default Cloud Storage bucket
FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
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://BUCKET_NAME
Numer projektu znajdziesz w sposób opisany w wprowadzeniu do projektów Firebase.
Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślnie ustawioną kontrolę dostępu, która zezwala na dostęp do Firebase. Jest to środek tymczasowy, który w przyszłości będzie wykonywany automatycznie.
Używanie niestandardowej aplikacji Firebase
Jeśli tworzysz bardziej skomplikowaną aplikację za pomocą niestandardowego obiektu FirebaseApp
, możesz utworzyć instancję obiektu Storage
zainicjalizowanego za pomocą tej aplikacji:
Swift
// 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")
Objective-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"];
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 Storage panelu.
Przejrzyj listę kontrolną przed wdrożeniem Firebase.