Instalación y configuración en plataformas de Apple

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

Firebase Realtime Database está disponible en todas las plataformas de Apple, incluidos iOS, macOS, Mac 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 en cualquier plataforma de Apple.

Requisitos previos

  1. Instala el SDK de Firebase.
  2. Agrega la app a tu proyecto de Firebase en Firebase console.

Crea una base de datos

  1. Ve a la sección Realtime Database de Firebase console. Se te pedirá que selecciones un proyecto de Firebase existente. Sigue el flujo de trabajo para crear la base de datos.

  2. Selecciona un modo de inicio para las reglas de seguridad de Firebase:

    Modo de prueba

    Es el modo recomendado si recién comienzas a usar las bibliotecas cliente para dispositivos móviles y la Web, pero permite que todos lean y reemplacen tus datos. Después de que realices las pruebas, asegúrate de revisar la sección Comprende las reglas de seguridad de Firebase Realtime Database.

    Si quieres comenzar a usar los SDK de Apple, Android o la Web, selecciona el modo de prueba.

    Modo bloqueado

    Rechaza todas las operaciones de lectura y escritura de clientes móviles y web. Tus servidores de aplicaciones autenticados aún pueden acceder a tu base de datos.

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

    Según la ubicación de la base de datos, la URL de la base de datos nueva tendrá uno de los siguientes formatos:

    • 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. Haz clic en Listo.

Cuando habilitas Realtime Database, también se habilita la API en el Administrador de API de Cloud.

Agrega Firebase Realtime Database a tu app

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

  1. En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.
  2. Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Elige la biblioteca de Realtime Database.
  5. Cuando termines, Xcode comenzará a resolver y descargar automáticamente tus dependencias en segundo plano.

Configura reglas de seguridad de Realtime Database

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

Cómo configurar Firebase Realtime Database

Debes inicializar Firebase antes de crear o usar cualquier referencia de la app de Firebase. Si ya lo hiciste con otra función de Firebase, puedes omitir este paso.

  1. Importa el módulo FirebaseCore en tu UIApplicationDelegate, así como en cualquier otro módulo de Firebase que use el delegado de la app. Por ejemplo, para usar Cloud Firestore y 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. Configura una instancia compartida de FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de la app:

    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. Si usas SwiftUI, debes crear un delegado de la aplicación y adjuntarlo al struct de tu App a través de UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. También debes inhabilitar el swizzling del delegado de la app. Para obtener más información, consulta las instrucciones de 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. Crea una referencia a tu base de datos y especifica la ubicación en la que deseas escribir.

    Swift

    Nota: Este producto de Firebase no está disponible en el destino de App Clips.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Objective-C

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

Próximos pasos