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 wieloplatformowe za pomocą naszych pakietów SDK na Androida, iOS i JavaScript, wszyscy Twoi klienci współdzielą jedną instancję Realtime Database i automatycznie otrzymują aktualizacje z najnowszymi danymi.

Usługa Firebase Realtime Database jest dostępna na wszystkich platformach Apple, w tym na urządzeniach z iOS, macOS, macOS Catalyst, tvOS i watchOS. Nie można jej używać w przypadku klipów w aplikacji. Instrukcje konfiguracji na tej stronie odnoszą się do iOS w przypadku konkretnych przykładów, ale są uniwersalne i działają na dowolnej platformie Apple.

Wymagania wstępne

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

Tworzenie bazy danych

  1. Otwórz sekcję Realtime Database w konsoli Firebase. Pojawi się prośba o wybranie dotychczasowego projektu Firebase. Wykonaj proces tworzenia bazy danych.

  2. Wybierz tryb początkowy dla urządzenia Firebase Security Rules:

    Tryb testowy

    Sprawdza się w przypadku rozpoczęcia korzystania z bibliotek klienta mobilnego i internetowego, ale pozwala każdemu odczytywać i zastępować Twoje dane. Po przetestowaniu zapoznaj się z sekcją Omówienie reguł Firebase Realtime Database.

    .

    Aby zacząć korzystać z pakietu SDK w wersji internetowej, Apple lub Android, wybierz tryb testowy.

    Tryb blokady

    Odrzuca wszystkie odczyty i zapisy z klientów mobilnych i internetowych. Uwierzytelnione serwery aplikacji nadal mogą uzyskać dostęp do 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 tych form:

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

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

  4. Kliknij Gotowe.

Włączenie Realtime Database powoduje również włączenie interfejsu API w Menedżerze interfejsów API w chmurze.

Dodawanie Firebase Realtime Database do aplikacji

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

  1. Po otwarciu projektu aplikacji w Xcode wybierz Plik > 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
  3. Wybierz bibliotekę Realtime Database.
  4. Dodaj flagę -ObjC w sekcji Inne flagi linkera w ustawieniach kompilacji docelowej.
  5. Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie zależności w tle.

Skonfiguruj: Realtime Database Security Rules

Realtime Database udostępnia język deklaratywny, który pozwala zdefiniować, jak powinny być ustrukturyzowane dane, jak je zindeksować i kiedy można je odczytywać i zapisywać.

Skonfiguruj usługę Firebase Realtime Database

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

  1. Zaimportuj moduł FirebaseCore w pliku UIApplicationDelegate, a także wszystkie inne moduły Firebase, których używa delegowany obiekt 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 współdzieloną instancję FirebaseApp w metodzie application(_:didFinishLaunchingWithOptions:) przedstawiciela 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ć przedstawiciela aplikacji i dołączyć go do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć swizlowanie zastępników aplikacji. 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. Utwórz odwołanie do bazy danych i określ lokalizację, do której chcesz zapisać dane.

    Swift

    Uwaga: ta usługa Firebase nie jest dostępna w miejscu docelowym wycinka aplikacji. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

    Uwaga: ta usługa Firebase nie jest dostępna w przypadku celu typu App Clip. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

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

Następne kroki