Instalacja i konfiguracja na platformach Apple

Baza danych czasu rzeczywistego Firebase to baza danych hostowana w chmurze. Dane są przechowywane w formacie JSON i synchronizowane w czasie rzeczywistym z każdym podłączonym klientem. Gdy tworzysz wieloplatformowe aplikacje za pomocą naszych zestawów SDK dla systemów Android, iOS i JavaScript, wszyscy Twoi klienci współdzielą jedną instancję Bazy danych czasu rzeczywistego i automatycznie otrzymują aktualizacje z najnowszymi danymi.

Baza danych czasu rzeczywistego Firebase jest dostępna na wszystkich platformach Apple, w tym iOS, macOS, macOS Catalyst, tvOS i watchOS. Nie jest dostępny dla klipów aplikacji. Instrukcje konfiguracji na tej stronie odnoszą się do systemu iOS w konkretnych przykładach, ale są ogólne i działają na dowolnej platformie docelowej Apple.

Wymagania wstępne

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

Utwórz bazę danych

  1. Przejdź do sekcji Baza danych czasu rzeczywistego w konsoli Firebase . Zostaniesz poproszony o wybranie istniejącego projektu Firebase. Postępuj zgodnie z przepływem pracy tworzenia bazy danych.

  2. Wybierz tryb uruchamiania reguł bezpieczeństwa Firebase:

    Tryb testowania

    Dobre do rozpoczęcia pracy z bibliotekami klienta mobilnego i internetowego, ale umożliwia każdemu odczytywanie i zastępowanie danych. Po przetestowaniu przejrzyj sekcję Omówienie zasad bazy danych czasu rzeczywistego Firebase .

    Aby rozpocząć korzystanie z pakietu SDK sieci Web, Apple lub Android, wybierz tryb testowy.

    Tryb zablokowany

    Odrzuca wszystkie odczyty i zapisy z klientów mobilnych i internetowych. Twoje uwierzytelnione serwery aplikacji mogą nadal uzyskiwać dostęp do Twojej bazy danych.

  3. Wybierz lokalizację dla bazy danych.

    W zależności od lokalizacji bazy danych adres URL nowej bazy danych będzie miał jedną z następujących postaci:

    • DATABASE_NAME .firebaseio.com (dla baz danych w us-central1 )

    • DATABASE_NAME . REGION .firebasedatabase.app (dla baz danych we wszystkich innych lokalizacjach)

  4. Kliknij Gotowe .

Włączenie bazy danych czasu rzeczywistego powoduje również włączenie interfejsu API w Cloud API Manager .

Dodaj bazę danych czasu rzeczywistego Firebase do swojej aplikacji

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

  1. W Xcode przy otwartym projekcie aplikacji przejdź do File > Add Packages .
  2. Po wyświetleniu monitu dodaj repozytorium Firebase Apple platforms SDK:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Wybierz bibliotekę Baza danych czasu rzeczywistego.
  5. Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie zależności w tle.

Skonfiguruj reguły bezpieczeństwa bazy danych w czasie rzeczywistym

Baza danych czasu rzeczywistego zapewnia język reguł deklaratywnych, który pozwala określić, w jaki sposób dane powinny być ustrukturyzowane, jak powinny być indeksowane oraz kiedy dane mogą być odczytywane i zapisywane.

Skonfiguruj bazę danych czasu rzeczywistego Firebase

Musisz zainicjować Firebase przed utworzeniem lub użyciem odwołania do aplikacji Firebase. Jeśli zrobiłeś to już dla innej funkcji Firebase, możesz pominąć ten krok.

  1. Zaimportuj moduł FirebaseCore do swojego UIApplicationDelegate , 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;
    // ...
          
  2. Skonfiguruj udostępnioną instancję FirebaseApp w metodzie application application(_: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];
  3. Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć go do struktury App za pośrednictwem UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor . 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()
          }
        }
      }
    }
          
  4. Utwórz odwołanie do swojej bazy danych i określ lokalizację, do której chcesz pisać.

    Szybki

    Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Cel C

    Uwaga: ten produkt Firebase nie jest dostępny w docelowym klipie aplikacji.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

Następne kroki