Wprowadzenie do Cloud Storage na platformach Apple

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści użytkowników, takich jak w postaci obrazów i filmów, co umożliwia umieszczanie w witrynie treści multimedialnych aplikacji. 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, co pozwala na obsługę niestabilnych sieci łatwość użycia.

Wymagania wstępne

  1. Zainstaluj pakiet SDK Firebase.
  2. Dodaj aplikację do projektu Firebase w konsoli Firebase.

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 projektu warto wziąć pod uwagę konfigurowanie reguł dostępu publicznego.

  3. Wybierz lokalizację domyślną. Zasobnik: Cloud Storage.

    • To ustawienie lokalizacji jest powiązane z ustawieniami domyślna lokalizacja zasobów Google Cloud Platform (GCP). 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 masz abonament Blaze, utworzyć wiele zasobników, każdy z własnym lokalizacja.

  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 uprawnienia do odczytu i zapisu w Aplikacja Cloud Storage jest ograniczona, więc tylko uwierzytelnieni użytkownicy mogą odczytywać i zapisywać i skalowalnych danych. Aby rozpocząć bez konfigurowania Authentication, możesz: skonfigurować reguły dostępu publicznego.

W ten sposób usługa Cloud Storage będzie dostępna dla wszystkich, nawet osób, które nie korzystają z Twojego Aplikacja, więc ponownie ogranicz dostęp do Cloud Storage, gdy ją skonfigurujesz. uwierzytelnianie.

Dodaj Cloud Storage do swojej aplikacji

Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.

  1. W Xcode po otwarciu projektu aplikacji przejdź do File > 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
  4. Wybierz bibliotekę Cloud Storage.
  5. Dodaj flagę -ObjC do sekcji Inne flagi łączące w ustawieniach kompilacji celu.
  6. Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie lub zależności w tle.

Skonfiguruj usługę Cloud Storage

Przed utworzeniem odwołania do Firebase lub . Jeśli zostało to już zrobione w przypadku innej funkcji Firebase, możesz pominąć ten krok, ten krok.

  1. Zaimportuj moduł FirebaseCore do UIApplicationDelegate, jak i wszelkie inne Moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć atrybutów Cloud Firestore i Authentication:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Skonfiguruj FirebaseApp współdzielonej instancji w uprawnieniach przedstawiciela aplikacji Metoda application(_:didFinishLaunchingWithOptions:):

    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. Jeśli używasz SwiftUI, musisz utworzyć i dołączyć przedstawiciela aplikacji. do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor Musisz też wyłączyć przełączanie przekazywania dostępu do aplikacji. Dla: 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()
          }
        }
      }
    }
          
  4. Uzyskaj odwołanie do usługi Cloud Storage, używając domyślnej aplikacji Firebase:

    Swift

    let storage = Storage.storage()

    Objective-C

    FIRStorage *storage = [FIRStorage storage];

Możesz już korzystać z Cloud Storage.

Najpierw dowiedzmy się, jak utworzyć Cloud Storage odwołania.

Konfiguracja zaawansowana

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

Pierwszy przypadek użycia jest idealny, jeśli masz użytkowników na całym świecie i chcesz i przechowywanie danych 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, gdy masz dane o różnych wzorcach dostępu. Możesz na przykład skonfigurować zasobnik dla wielu regionów lub jeden region, w którym będzie przechowywana zdjęcia lub inne często używane treści, a także zbiór zdjęć Nearline lub Coldline, który zawiera kopie zapasowe użytkowników lub inne rzadko używane treści.

W każdym z tych przypadków warto wykonać korzystają z 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). Możesz użyć 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 FIRStorage, które odwołuje się do Twojego zasobnika 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 do Firebase istniejącego zasobnika Cloud Storage musisz przyznać Firebase dostęp do tych plików za pomocą gsutil, dostępne w Pakiet SDK Google Cloud:

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 ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślny dostęp aby zezwolić na używanie 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 złożoną aplikację, korzystając z niestandardowego interfejsu FirebaseApp, możesz: utwórz instancję Storage zainicjowaną z tą aplikacją:

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