Instalación y Configuración en plataformas Apple

Firebase Realtime Database es una base de datos alojada en la nube. Los datos se almacenan como JSON y se sincronizan en tiempo real con cada cliente conectado. Cuando crea aplicaciones multiplataforma con nuestros SDK de Android, iOS y JavaScript, todos sus clientes comparten una instancia de Realtime Database y reciben automáticamente actualizaciones con los datos más recientes.

Firebase Realtime Database está disponible en todas las plataformas de Apple, incluidas iOS, macOS, macOS Catalyst, tvOS y watchOS. No está disponible para App Clips. Las instrucciones de configuración de esta página hacen referencia a iOS en ejemplos específicos, pero son genéricas y funcionan para cualquier plataforma Apple.

Requisitos previos

  1. Instale el SDK de Firebase .
  2. Agrega tu aplicación a tu proyecto de Firebase en Firebase console .

Crear una base de datos

  1. Navegue a la sección Base de datos en tiempo real de Firebase console . Se te pedirá que selecciones un proyecto de Firebase existente. Siga el flujo de trabajo de creación de la base de datos.

  2. Seleccione un modo de inicio para sus reglas de seguridad de Firebase:

    Modo de prueba

    Bueno para comenzar con las bibliotecas de clientes web y móviles, pero permite que cualquiera lea y sobrescriba sus datos. Después de la prueba, asegúrese de revisar la sección Comprender las reglas de la base de datos en tiempo real de Firebase .

    Para comenzar con el SDK web, Apple o Android, seleccione el modo de prueba.

    Modo bloqueado

    Niega todas las lecturas y escrituras desde clientes web y móviles. Sus servidores de aplicaciones autenticados aún pueden acceder a su base de datos.

  3. Elija una ubicación para la base de datos.

    Dependiendo de la ubicación de la base de datos , la URL de la nueva base de datos tendrá una de las siguientes formas:

    • DATABASE_NAME .firebaseio.com (para bases de datos en us-central1 )

    • DATABASE_NAME . REGION .firebasedatabase.app (para bases de datos en todas las demás ubicaciones)

  4. Haga clic en Listo.

Cuando habilita Realtime Database, también habilita la API en Cloud API Manager .

Agregue Firebase Realtime Database a su aplicación

Utilice Swift Package Manager para instalar y administrar las dependencias de Firebase.

  1. En Xcode, con el proyecto de su aplicación abierto, navegue hasta Archivo > Agregar paquetes .
  2. Cuando se le solicite, agregue el repositorio SDK de las plataformas Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Elija la biblioteca de bases de datos en tiempo real.
  5. Agregue el indicador -ObjC a la sección Otros indicadores del vinculador de la configuración de compilación de su objetivo.
  6. Cuando termine, Xcode comenzará automáticamente a resolver y descargar sus dependencias en segundo plano.

Configurar reglas de seguridad de bases de datos en tiempo real

Realtime Database proporciona un lenguaje de reglas declarativas que le permite definir cómo se deben estructurar los datos, cómo se deben indexar y cuándo se pueden leer y escribir los datos.

Configurar la base de datos en tiempo real de Firebase

Debes inicializar Firebase antes de crear o utilizar cualquier referencia de aplicación de Firebase. Si ya hizo esto para otra función de Firebase, puede omitir este paso.

  1. Importe el módulo FirebaseCore en su UIApplicationDelegate , así como cualquier otro módulo de Firebase que utilice el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:

    Interfaz de usuario rápida

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    C objetivo

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure una instancia compartida FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de su aplicación:

    Interfaz de usuario rápida

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Rápido

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    C objetivo

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Si está utilizando SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura App mediante UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . También debes desactivar el cambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .

    Interfaz de usuario rápida

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. Cree una referencia a su base de datos y especifique la ubicación en la que desea escribir.

    Rápido

    Nota: Este producto de Firebase no está disponible en el destino del clip de aplicación.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    C objetivo

    Nota: Este producto de Firebase no está disponible en el destino del clip de aplicación.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

Próximos pasos