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 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ę 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 na iOS, macOS, macOS Catalyst, tvOS i watchOS. Ta funkcja nie jest dostępna w przypadku klipów z aplikacji. Instrukcje konfiguracji na tej stronie dotyczą urządzeń z iOS w określonych przykładach, ale są ogólne i sprawdzają się w przypadku wszystkich docelowych platform Apple.

Wymagania wstępne

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

Utwórz bazę danych

  1. W konsoli Firebase przejdź do sekcji Baza danych czasu rzeczywistego. Pojawi się prośba o wybranie istniejącego projektu Firebase. Postępuj zgodnie z procedurą tworzenia bazy danych.

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

    Tryb testowy

    Sprawdza się w przypadku rozpoczęcia korzystania z bibliotek klienta mobilnego i internetowego, ale pozwala każdemu na odczyt i zastępowanie Twoich danych. Po zakończeniu testów zapoznaj się z sekcją Omówienie reguł bazy danych czasu rzeczywistego Firebase.

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

    Tryb blokady

    Blokuje 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 jej adres URL może mieć jedną z tych form:

    • DATABASE_NAME.firebaseio.com (na potrzeby baz danych w regionie us-central1)

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

  4. Kliknij Gotowe.

Gdy włączysz Bazę danych czasu rzeczywistego, zostanie też włączony interfejs API w menedżerze interfejsów API Cloud.

Dodaj Bazę danych czasu rzeczywistego Firebase do swojej aplikacji

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

  1. Po otwarciu projektu aplikacji przejdź w Xcode do File > Add Packages (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ę Bazy danych czasu rzeczywistego.
  4. Dodaj flagę -ObjC do sekcji Inne flagi łączące w ustawieniach kompilacji celu.
  5. Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie zależności w tle.

Konfigurowanie reguł zabezpieczeń bazy danych czasu rzeczywistego

Baza danych czasu rzeczywistego udostępnia język z regułami deklaratywnymi, które pozwalają definiować strukturę danych, sposób ich indeksowania oraz możliwość odczytywania i zapisywania danych.

Skonfiguruj Bazę danych czasu rzeczywistego Firebase

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 do obiektu UIApplicationDelegate, a także wszystkie inne moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć Cloud Firestore i Uwierzytelniania:

    Certyfikat 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:

    Certyfikat 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ć przełączanie przekazywania dostępu do aplikacji. Więcej informacji znajdziesz w instrukcjach SwiftUI.

    Certyfikat 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ę, w której chcesz zapisywać dane.

    Swift

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

ref = Database.database().reference()

    Objective-C

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

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

Następne kroki