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 rich media. Twoje dane są przechowywane w Google Cloud Storage zasobniku – rozwiązaniu do przechowywania obiektów o skali eksabajtów, które charakteryzuje się 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 łatwe radzenie sobie z niestabilnymi sieciami.

Zanim zaczniesz

  1. Jeśli jeszcze tego nie zrobisz, zapoznaj się z przewodnikiem dla początkujących dotyczącym aplikacji na platformy Apple. Obejmuje to m.in.:

    • Tworzenie projektu w Firebase.

    • Rejestrowanie aplikacji na platformy Apple w projekcie i łączenie aplikacji z Firebase przez dodanie biblioteki Firebase i pliku konfiguracyjnego Firebase (GoogleService-Info.plist) do aplikacji.

  2. Upewnij się, że Twój projekt w Firebase korzysta z planu taryfowego Blaze z płatnością według wykorzystania, który jest wymagany do korzystania z Cloud Storage dla Firebase.Cloud Storage for Firebase Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy kwalifikujesz się do otrzymania bezpłatnych środków w wysokości 300 USD w ramach wersji próbnej.

Tworzenie domyślnego zasobnikaCloud Storage

  1. W konsoli Firebase otwórz Bazy danych i miejsce na dane > Miejsce na dane.

    Jeśli Twój projekt nie korzysta jeszcze z planu taryfowego Blaze z płatnością według wykorzystania, pojawi się prośba o przejście na ten plan.

  2. Kliknij Rozpocznij.

  3. Wybierz lokalizację domyślnego zasobnika.

  4. Skonfiguruj Firebase Security Rules dla domyślnego zasobnika. Podczas programowania, rozważ skonfigurowanie reguł dostępu publicznego.

  5. Kliknij Gotowe.

Teraz możesz wyświetlić zasobnik w konsoli Firebase (otwórz kartę Bazy danych i miejsce na dane > Miejsce na dane > Pliki). Format nazwy domyślnego zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia deklaratywny język reguł, który umożliwia określenie struktury danych, sposobu ich indeksowania oraz tego, kiedy dane można odczytywać i zapisywać. 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ąć korzystanie z usługi bez konfigurowania Authentication, możesz skonfigurować reguły dostępu publicznego.

Sprawia to, że Cloud Storage jest otwarty 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 do zarządzania nimi możesz używać menedżera pakietów Swift.

  1. Po otwarciu projektu aplikacji wybierz w Xcode kolejno File (Plik) > Add Packages (Dodaj pakiety).
  2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Wybierz bibliotekę Cloud Storage.
  4. Dodaj flagę -ObjC do sekcji Other Linker Flags w ustawieniach kompilacji celu.
  5. Gdy skończysz, Xcode zacznie automatycznie wyszukiwać i pobierać Twoje zależności w tle.

Konfigurowanie Cloud Storage w aplikacji

  1. Zainicjuj Firebase, zanim utworzysz lub użyjesz odniesienia do Firebase.

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

    1. Zaimportuj moduł FirebaseCore i moduł FirebaseStorage w 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 FirebaseApp współdzieloną instancję w metodzie application(_:didFinishLaunchingWithOptions:) delegata 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ć swizzling delegata aplikacji. Więcej informacji znajdziesz w instrukcjach dotyczących 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 odniesienie do usługi Cloud Storage za pomocą domyślnej aplikacji Firebase.

    1. Upewnij się, że plik konfiguracyjny Firebase (GoogleService-Info.plist) w bazie kodu aplikacji jest zaktualizowany o nazwę domyślnego zasobnikaCloud Storage.

      1. Pobierz zaktualizowany plik konfiguracyjny..

      2. Użyj pobranego pliku konfiguracyjnego, aby zastąpić istniejący plik GoogleService-Info.plist w katalogu głównym projektu Xcode. Jeśli pojawi się prośba, wybierz opcję dodania pliku konfiguracyjnego do wszystkich celów.

        Upewnij się, że w aplikacji masz tylko ten najnowszy pobrany plik konfiguracyjny i że jego nazwa nie zawiera dodatkowych znaków, np. (2).

    2. Uzyskaj odniesienie 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ąć korzystać z Cloud Storage!

Następny krok? Dowiedz się, jak utworzyć odniesienie Cloud Storage.

Konfiguracja zaawansowana

W kilku przypadkach użycia wymagana jest dodatkowa konfiguracja:

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, aby przechowywać dane użytkowników z tych regionów i zmniejszyć opóźnienie.

Drugi przypadek użycia jest przydatny, jeśli masz dane o różnych wzorcach dostępu. Możesz na przykład skonfigurować zasobnik wieloregionowy 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 tych przypadkach użycia warto korzystać z kilku Cloud Storage zasobników.

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom logowanie się na kilka kont (np. konto osobiste i konto służbowe). Do uwierzytelniania każdego dodatkowego konta możesz użyć niestandardowej instancji aplikacji Firebase.

Korzystanie z kilku zasobników Cloud Storage

Jeśli chcesz używać zasobnika Cloud Storage innego niż domyślny lub używać kilku zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję FIRStorage, która odwołuje się do Twojego 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 importowanymi zasobnikami

Podczas importowania istniejącego zasobnika Cloud Storage do Firebase musisz przyznać Firebase dostęp do tych plików za pomocą narzędzia gsutil zawartego w 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 we wprowadzeniu do projektów Firebase.

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślną kontrolę dostępu ustawioną na zezwalanie Firebase. Jest to środek tymczasowy, który w przyszłości będzie wykonywany automatycznie.

Korzystanie z niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej złożoną aplikację, która korzysta z niestandardowej aplikacji FirebaseApp, możesz utworzyć instancję Storage zainicjowaną 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