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, wszystkie Twoje aplikacje 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 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 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 i 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
  4. Wybierz bibliotekę Realtime Database.
  5. Dodaj flagę -ObjC do sekcji Inne flagi linkera w ustawieniach kompilacji docelowej.
  6. 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ć strukturę danych, sposób ich indeksowania oraz czas, w którym można je odczytywać i zapisywać.

Skonfiguruj usługę Firebase Realtime Database

Zanim utworzona lub użyta zostanie jakakolwiek referencja do aplikacji Firebase, musisz zainicjować 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 oraz wszystkie inne moduły Firebase, których używa delegowany obiekt aplikacji. Aby na przykład użyć właściwości Cloud FirestoreAuthentication:

    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