Wprowadzenie do Cloud Storage na platformach Apple

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 w aplikacjach treści multimedialnych. 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 sprawne działanie w przypadku niestabilnych sieci.

Zanim zaczniesz

  1. Jeśli jeszcze tego nie zrobisz, zapoznaj się z przewodnikiem wprowadzającym na temat aplikacji na platformy Apple. Obejmuje to m.in.:

    • Tworzę projekt Firebase.

    • Aby zarejestrować w projekcie aplikację platformy Apple i połączyć ją z Firebase, dodaj do niej bibliotekę Firebase i plik konfiguracyjny Firebase (GoogleService-Info.plist).

  2. Upewnij się, że Twój projekt Firebase jest objęty abonamentem Blaze (płatność według wykorzystania). 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

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

  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.

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 reguł deklaratywnych, który pozwala zdefiniować, jak powinny być uporządkowane dane, w jaki sposób powinny być indeksowane oraz kiedy dane mogą być odczytywane i zapisywane. Domyślnie dostęp do odczytu i zapisu do 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 Cloud Storage do swojej aplikacji

Do instalacji zależności Firebase i zarządzania nimi możesz używać menedżera pakietów Swift.

  1. Po otwarciu projektu aplikacji w Xcode wybierz Plik > Dodaj pakiety.
  2. Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Wybierz bibliotekę Cloud Storage.
  4. Dodaj flagę -ObjC do sekcji Inne flagi łączące w ustawieniach kompilacji celu.
  5. Gdy to zrobisz, Xcode automatycznie zacznie wyszukiwać i pobierać zależności w tle.

Konfigurowanie Cloud Storage w aplikacji

  1. Zainicjuj Firebase przed utworzeniem lub użyciem dowolnego odwołania do Firebase.

    Być może jest to już zrobione, jeśli masz już skonfigurowaną inną usługę Firebase, ale musisz jeszcze dodać bibliotekę FirebaseStorage do listy importów.

    1. Zaimportuj moduły FirebaseCore i FirebaseStorage do UIApplicationDelegate. Zalecamy też dodanie FirebaseAuth.

      SwiftUI 

      import SwiftUI
import FirebaseCore
import FirebaseStorage
import FirebaseAuth
// ...

      Swift 

      import FirebaseCore
import FirebaseStorage
import FirebaseAuth
// ...

      Objective-C 

      @import FirebaseCore;
@import FirebaseStorage;
@import FirebaseAuth;
// ...

    2. Skonfiguruj współdzieloną instancję FirebaseApp w metodzie application(_: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];

    3. (Tylko SwiftUI) Utwórz delegata aplikacji i dołącz go do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć wirowanie przekazywania dostępu do 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()
      }
    }
  }
}

  2. Uzyskaj odwołanie do usługi Cloud Storage, korzystając z domyślnej aplikacji Firebase.

    1. Sprawdź, czy plik konfiguracji Firebase (GoogleService-Info.plist) w kodzie źródłowym aplikacji zawiera zaktualizowaną nazwę domyślnego zasobnika Cloud Storage.

      1. Uzyskaj zaktualizowany plik konfiguracji.

      2. 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 docelowych urządzeń.

        Upewnij się, że w aplikacji jest tylko ostatnio pobrany plik konfiguracji i że jego nazwa nie zawiera dodatkowych znaków, np. (2).

    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:

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ć zasobniki w Stanach Zjednoczonych, Europie i Azji do przechowywania danych użytkowników w tych regionach, aby skrócić czas oczekiwania.

Drugi przypadek użycia jest przydatny, jeśli masz dane z różnymi wzorami dostępu. Możesz na przykład skonfigurować wieloregionalny lub regionalny zasobnik do przechowywania zdjęć lub innych często używanych treści, a także 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óra pozwala użytkownikom mieć więcej niż jedno konto (na przykład 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 niestandardowego zasobnika:

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ż ich domyślna kontrola dostępu zezwala na korzystanie z 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