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 różne platformy za pomocą naszych pakietów SDK na Androida, iOS i JavaScript, wszyscy Twoi klienci korzystają z tej samej instancji Realtime Database i automatycznie otrzymują aktualizacje z najnowszymi danymi.

Firebase Realtime Database jest dostępny 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 odnoszą się do iOS w konkretnych przykładach, 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 Firebase w konsoli Firebase.

Tworzenie bazy danych

  1. W konsoli Firebase kliknij Bazy danych i pamięć masowa > Baza danych czasu rzeczywistego.

  2. Kliknij Utwórz bazę danych.

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

    Tryb testowy

    Dobry sposób na rozpoczęcie korzystania z bibliotek klienta mobilnego i internetowego, ale umożliwia każdemu odczytywanie i zastępowanie Twoich danych. Po zakończeniu testów zapoznaj się z sekcją Reguły Bazy danych czasu rzeczywistego Firebase.

    Aby rozpocząć korzystanie z pakietu SDK dla aplikacji internetowych, na urządzenia Apple lub z Android SDK, wybierz tryb testowy.

    Tryb blokady

    Odrzucanie wszystkich odczytów i zapisów z 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 form:

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

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

  5. Kliknij Gotowe.

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

Dodawanie Firebase Realtime Database do aplikacji

Do instalowania zależności Firebase i zarządzania nimi używaj menedżera pakietów Swift.

  1. W Xcode, gdy projekt aplikacji jest otwarty, kliknij 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 łączące) w ustawieniach kompilacji celu.
  5. Gdy skończysz, Xcode zacznie automatycznie przetwarzać i pobierać zależności w tle.

Skonfiguruj funkcję Realtime Database Security Rules

Realtime Database udostępnia deklaratywny język reguł, który pozwala określić, jak dane mają być ustrukturyzowane i indeksowane oraz 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 zostało to już zrobione w przypadku innej funkcji Firebase, możesz pominąć ten krok.

  1. Zaimportuj moduł FirebaseCore do pliku UIApplicationDelegate oraz wszystkie inne moduły Firebase, których używa delegat 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 udostępnioną instancję FirebaseApp 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ć obiekt delegowany 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 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 przypadku celu App Clip. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

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

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

Następne kroki