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ą pakietów SDK na Androida, iOS i JavaScript, wszyscy Twoi klienci korzystają z jednego wystąpienia Realtime Database i automatycznie otrzymują aktualizacje z najnowszymi danymi.

Firebase Realtime Database jest dostępna na wszystkich platformach Apple, w tym na 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 każdej platformie Apple.

Wymagania wstępne

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

Tworzenie bazy danych

  1. W konsoli Firebase otwórz sekcję Realtime Database. Pojawi się prośba o wybranie dotychczasowego projektu Firebase. Postępuj zgodnie z procesem tworzenia bazy danych.

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

    Tryb testowy

    Jest to dobre rozwiązanie na początek korzystania z bibliotek klienta mobilnego i internetowego, ale pozwala każdemu odczytywać i zapisywać Twoje dane. Po przetestowaniu zapoznaj się z sekcją Omówienie reguł Firebase Realtime Database.

    Aby zacząć korzystać z pakietu SDK do przeglądarki, Apple lub Androida, wybierz tryb testowy.

    Tryb blokady

    Odrzuca wszystkie odczyty i zapisy z klientów mobilnych oraz 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 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.

Gdy włączysz Realtime Database, interfejs API zostanie też włączony w Menedżerze interfejsów API w chmurze.

Dodawanie Firebase Realtime Database do aplikacji

Do instalacji zależności Firebase i zarządzania nimi możesz używać menedżera pakietów Swift.

  1. Po otwarciu projektu aplikacji w Xcode wybierz 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 Inne flagi linkera w ustawieniach kompilacji docelowej.
  5. Gdy to zrobisz, Xcode automatycznie zacznie wyszukiwać i pobierać zależności w tle.

Skonfiguruj: Realtime Database Security Rules

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

Skonfiguruj usługę Firebase Realtime Database

Musisz zainicjować Firebase, zanim utworzysz lub użyjesz odwołania do aplikacji Firebase. Jeśli masz już włączoną tę funkcję w innej usłudze 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ć właściwości 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:) w delegacie 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ć obiekt delegujący aplikacji i dołączyć go do struktury App za pomocą funkcji 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 przypadku celu typu App Clip. 
    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