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 na każdym połączonym kliencie. Gdy tworzysz aplikacje na różne platformy za pomocą naszych pakietów SDK na Androida, iOS i JavaScript, wszyscy Twoi klienci korzystają z jednej 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 klipów aplikacji. Instrukcje konfiguracji na tej stronie zawierają przykłady dotyczące iOS, ale są ogólne i działają w przypadku każdej platformy docelowej Apple.

Wymagania wstępne

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

Tworzenie bazy danych

  1. Przejdź do sekcji Realtime Database w Firebasekonsoli. 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

    Dobre rozwiązanie na początek korzystania z bibliotek klienta mobilnego i internetowego, ale umożliwia odczytywanie i zastępowanie danych przez dowolną osobę. Po przetestowaniu zapoznaj się z sekcją Omówienie reguł Bazy danych czasu rzeczywistego Firebase.

    Aby rozpocząć korzystanie z pakietu SDK na potrzeby internetu, urządzeń Apple lub Androida, wybierz tryb testowy.

    Tryb blokady

    Odrzuca wszystkie odczyty i zapisy klientów mobilnych oraz internetowych. Uwierzytelnione serwery aplikacji nadal mogą uzyskiwać 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 postaci:

    • DATABASE_NAME.firebaseio.com (w przypadku baz danych w 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 Cloud API Manager.

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 projektu.
  5. Gdy skończysz, Xcode zacznie automatycznie wyszukiwać i pobierać zależności w tle.

Skonfiguruj: Realtime Database Security Rules

Realtime Database udostępnia deklaratywny język reguł, który pozwala określić, jak dane mają być strukturyzowane i indeksowane oraz kiedy można je odczytywać i zapisywać.

Skonfiguruj usługę Firebase Realtime Database

Musisz zainicjować Firebase, zanim utworzysz lub użyjesz jakiegokolwiek odwołania do aplikacji Firebase. Jeśli masz już to zrobione w przypadku innej funkcji Firebase, możesz pominąć ten krok.

  1. Zaimportuj moduł FirebaseCore w pliku UIApplicationDelegate, a także inne moduły Firebase używane przez delegata 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:) 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ć zamianę 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 zapisać dane.

    Swift

    Uwaga: ta usługa Firebase nie jest dostępna w przypadku klipów z aplikacji. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

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

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

Następne kroki