Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Agrega Firebase a tu app de Flutter

Sigue esta guía para agregar los productos de Firebase a una app de Flutter.

Requisitos previos

  • Instala el editor o IDE que prefieras.

  • Asegúrate de que tu app de Flutter se oriente a iOS 8 o una versión posterior.

  • Configura un dispositivo iOS físico o un simulador para ejecutar la app.

    • En el caso de Cloud Messaging, debes completar las siguientes tareas:

      • Configura un dispositivo iOS físico.
      • Obtén una clave de autenticación de notificaciones push de Apple para tu cuenta de Apple Developer.
      • En Xcode, habilita las notificaciones push en App > Capabilities.
    • En todos los demás productos de Firebase, puedes usar un dispositivo iOS físico o el simulador.

  • Instala Flutter para tu sistema operativo específico, incluidos estos componentes:

    • SDK de Flutter
    • Bibliotecas compatibles
    • Software y SDK específicos para cada plataforma
  • Accede a Firebase con tu Cuenta de Google.

Si todavía no tienes una app de Flutter, puedes seguir los pasos del instructivo Get started: Test drive para crear una nueva usando el editor o IDE que prefieras.

Paso 1: Crea un proyecto de Firebase

Antes de que puedas agregar Firebase a tu app para Flutter, debes crear un proyecto de Firebase y conectarlo a ella. Visita Información sobre los proyectos de Firebase para obtener más detalles sobre este tema.

Paso 2: Registra tu app con Firebase

  1. En el centro de la página de descripción general del proyecto en Firebase console, haz clic en el ícono de iOS () para iniciar el flujo de trabajo de configuración.

    Si ya agregaste una app a tu proyecto de Firebase, haz clic en Agregar app para que se muestren las opciones de plataforma.

  2. Ingresa el ID del paquete de tu app en el campo ID del paquete de iOS.

    Podrás encontrar el ID del paquete en el proyecto abierto en Xcode. Selecciona la app de nivel superior en el navegador del proyecto y, luego, accede a la pestaña General. El valor Identificador de paquete es el ID del paquete de iOS (por ejemplo, com.yourcompany.ios-app-name).

  3. Ingresa otra información de la app si el flujo de trabajo de configuración lo solicita (opcional).

  4. Haz clic en Registrar app.

Paso 3: Agrega un archivo de configuración de Firebase

  1. Haz clic en Descargar GoogleService-Info.plist a fin de obtener el archivo de configuración de Firebase para iOS (GoogleService-Info.plist).

  2. Usa Xcode para mover el archivo al directorio Runner/Runner de tu app de Flutter.

  3. Vuelve al flujo de trabajo de configuración de Firebase console y haz clic en Siguiente para omitir los pasos restantes.

  4. Continúa con el paso Agrega complementos de FlutterFire.

Paso 4: Agrega complementos de FlutterFire

Flutter utiliza complementos para brindar acceso a una amplia variedad de servicios específicos de cada plataforma, como las API de Firebase. Los complementos incluyen código específico de la plataforma para acceder a los servicios y las API en cada una de ellas.

Se puede acceder a Firebase a través de varias bibliotecas distintas, una por cada producto de Firebase (por ejemplo: Realtime Database, Authentication, Analytics o Cloud Storage). Flutter ofrece un grupo de complementos de Firebase que, en conjunto, se denomina FlutterFire.

Como Flutter es un SDK que admite varias plataformas, cada complemento de FlutterFire funciona en iOS y Android. Por lo tanto, si agregas uno de estos complementos a tu app de Flutter, este se usará tanto en la versión para iOS como para Android de tu app de Firebase.

Asegúrate de revisar la documentación de FlutterFire para ver la lista más actualizada de sus complementos.

  1. Asegúrate de que tu app no esté en ejecución ni en el emulador ni en el dispositivo.

  2. Desde el directorio raíz de tu app de Flutter, abre el archivo pubspec.yaml.

  3. Agrega el complemento de FlutterFire para el SDK de Firebase Core Flutter.

    dependencies:
      flutter:
        sdk: flutter
      # Add the dependency for the Firebase Core Flutter SDK
      firebase_core: ^0.4.0+9
    
  4. Agrega los complementos de FlutterFire para los productos de Firebase que quieres usar en tu app.

    Si Analytics está habilitado

    dependencies:
      flutter:
        sdk: flutter
      # Check that you have this dependency (added in the previous step)
      firebase_core: ^0.4.0+9
    # Add the dependency for the FlutterFire plugin for Google Analytics firebase_analytics: ^5.0.2
    # Add the dependencies for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore firebase_auth: ^0.14.0+5 cloud_firestore: ^0.12.9+5

    Si Analytics está inhabilitado

    dependencies:
      flutter:
        sdk: flutter
      # Check that you have this dependency (added in the previous step)
      firebase_core: ^0.4.0+9
    # Add the dependencies for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore firebase_auth: ^0.14.0+5 cloud_firestore: ^0.12.9+5
  5. Ejecuta flutter packages get.
    Si necesitas más información para administrar paquetes y complementos, consulta Using packages.

  6. Si agregaste Analytics, ejecuta tu app para enviar la verificación a Firebase de que lo integraste correctamente. De lo contrario, puedes omitir el paso de verificación.

Listo. La app de Flutter se registró y configuró para usar Firebase.

Prueba una app de ejemplo con Analytics

Como todos los paquetes, el complemento firebase_analytics incluye un programa de ejemplo.

  1. Abre una app de Flutter que ya hayas configurado para usar Firebase (consulta las instrucciones en esta página).

  2. Accede al directorio lib de la app y, luego, borra el archivo main.dart existente.

  3. Copia y pega los siguientes dos archivos en el directorio lib de la app desde el repositorio del programa de ejemplo de Google Analytics:

    • main.dart
    • tabs_page.dart
  4. Ejecuta la app de Flutter.

  5. Ve al proyecto de Firebase de tu app en Firebase console y, luego, haz clic en Analytics en el panel de navegación izquierdo.

    • Haz clic en Panel. Si Analytics funciona correctamente, se mostrará un usuario activo en el panel “Usuarios activos en los últimos 30 minutos” (esta información podría tardar en propagarse).

    • Haz clic en DebugView. Habilita la función para ver todos los eventos que generó el programa de ejemplo.

Si quieres obtener más detalles sobre la configuración de Analytics, consulta las guías de introducción para iOS y Android.

Próximos pasos