Instalacja & Konfiguracja na platformach Apple

Baza danych Firebase Realtime Database to baza danych hostowana w chmurze. Dane są przechowywane w formacie JSON i synchronizowane w czasie rzeczywistym z każdym podłączonym klientem. Kiedy tworzysz aplikacje wieloplatformowe za pomocą naszych zestawów SDK dla systemów Android, iOS i JavaScript, wszyscy Twoi klienci korzystają z jednej instancji bazy danych Realtime Database i automatycznie otrzymują aktualizacje z najnowszymi danymi.

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

Warunki 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 procesem tworzenia bazy danych.

  2. Wybierz tryb początkowy dla reguł bezpieczeństwa Firebase:

    Tryb testowania

    Dobry do rozpoczęcia pracy z bibliotekami klienta mobilnego i internetowego, ale umożliwia każdemu odczytywanie i nadpisywanie danych. Po przetestowaniu koniecznie zapoznaj się z sekcją Omówienie reguł bazy danych Firebase Realtime .

    Aby rozpocząć korzystanie z Internetu, zestawu SDK Apple lub Androida, wybierz tryb testowy.

    Tryb zablokowany

    Zabrania wszelkich odczytów i zapisów z klientów mobilnych i internetowych. Twoje uwierzytelnione serwery aplikacji nadal mają dostęp do Twojej bazy danych.

  3. Wybierz lokalizację bazy danych.

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

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

    • DATABASE_NAME . REGION .firebasedatabase.app (dla baz danych we wszystkich pozostałych lokalizacjach)

  4. Kliknij Gotowe .

Włączenie bazy danych czasu rzeczywistego powoduje także włączenie interfejsu API w menedżerze Cloud API .

Dodaj bazę danych czasu rzeczywistego Firebase do swojej aplikacji

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

  1. W Xcode, przy otwartym projekcie aplikacji, przejdź do File > Add Packages .
  2. Po wyświetleniu monitu dodaj repozytorium SDK platform Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Wybierz bibliotekę bazy danych czasu rzeczywistego.
  5. Dodaj flagę -ObjC do sekcji Inne flagi linkera w ustawieniach kompilacji celu.
  6. 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 udostępnia język reguł deklaratywnych, który umożliwia zdefiniowanie struktury danych, sposobu ich indeksowania oraz tego, kiedy dane mogą być odczytywane i zapisywane.

Skonfiguruj bazę danych czasu rzeczywistego Firebase

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

  1. Zaimportuj moduł FirebaseCore do swojego UIApplicationDelegate , a także wszelkie inne moduły Firebase, których używa 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 aplikacji delegata application(_:didFinishLaunchingWithOptions:) metoda:

    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, zapoznaj się z instrukcjami 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 odniesienie do swojej bazy danych i określ lokalizację, w 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