Instalacja Konfiguracja na platformach Apple

Firebase Realtime Database to baza danych hostowana w chmurze. Dane są przechowywane w formacie JSON i synchronizowane w czasie rzeczywistym z każdym połączonym klientem. Gdy tworzysz aplikacje na wielu platformach za pomocą naszych pakietów SDK na Androida, iOS i JavaScript, wszyscy Twoi klienci korzystają z jednej Realtime Database instancji i automatycznie otrzymują aktualizacje z najnowszymi danymi.

Firebase Realtime Database jest dostępna na wszystkich platformach Apple, w tym iOS, macOS, macOS Catalyst, tvOS i watchOS. Nie jest dostępna w przypadku wycinków aplikacji. Instrukcje konfiguracji na tej stronie zawierają konkretne przykłady dotyczące iOS, ale są ogólne i działają na każdej platformie Apple.

Wymagania wstępne

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

Tworzenie bazy danych

  1. W konsoli Firebase otwórz Bazy danych i miejsce na dane > Baza danych czasu rzeczywistego.

  2. Kliknij Utwórz bazę danych.

  3. Wybierz tryb początkowy dla Firebase Security Rules:

    Tryb testowy

    Dobry sposób na rozpoczęcie pracy z bibliotekami klienta mobilnego i internetowego, ale umożliwia każdemu odczytywanie i nadpisywanie danych. Po testach zapoznaj się z sekcją Informacje o regułach Bazy danych czasu rzeczywistego Firebase sekcją.

    Aby rozpocząć korzystanie z pakietu SDK na Androida, iOS lub JavaScript, wybierz tryb testowy.

    Tryb blokady

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

  4. Wybierz lokalizację bazy danych.

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

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

    • DATABASE_NAME.REGION.firebasedatabase.app (w przypadku baz danych w innych lokalizacjach)

  5. Kliknij Gotowe.

Gdy włączysz Realtime Database, włączy się też interfejs API w Menedżerze interfejsów API w chmurze.

Dodawanie Firebase Realtime Database 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 opcję File > Add Packages (Plik > 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ę Realtime Database.
  4. Dodaj flagę -ObjC do sekcji Other Linker Flags (Inne flagi linkera) w ustawieniach kompilacji celu.
  5. Gdy skończysz, Xcode zacznie automatycznie wyszukiwać i pobierać Twoje zależności w tle.

Konfigurowanie Realtime Database Security Rules

Realtime Database 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ć.

Konfigurowanie Firebase Realtime Database

Zanim utworzysz lub użyjesz odniesienia do aplikacji w Firebase, musisz zainicjować Firebase. Jeśli masz już to zrobione w przypadku innej funkcji Firebase, możesz pominąć ten krok.

  1. Zaimportuj moduł FirebaseCore w UIApplicationDelegate, a także inne moduły Firebase, których używa delegat aplikacji. Na przykład, aby używać 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ół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. Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć 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()
      }
    }
  }
}
  4. Utwórz odniesienie do bazy danych i określ lokalizację, w której chcesz zapisywać dane.

    Swift

    Uwaga: ten produkt Firebase nie jest dostępny w przypadku celu wycinka aplikacji. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

    Uwaga: ten produkt Firebase nie jest dostępny w przypadku celu wycinka aplikacji. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

Następne kroki