Saltar al contenido principal

Firebase Crashlytics para aplicaciones Capacitor

Aprende a integrar el informe de errores en tiempo real en tus aplicaciones móviles con una guía paso a paso para configurar Crashlytics tanto para iOS como para Android.

Martín Donadieu

Martín Donadieu

Gerente de contenido

Firebase Crashlytics para aplicaciones Capacitor

Firebase Crashlytics te ayuda a rastrear los errores de la aplicación en tiempo real, proporcionando informes detallados para solucionar problemas rápidamente. Se integra de manera suave con Capacitor para aplicaciones de iOS y Android. Aquí está lo que debes saber:

  • ¿Por qué usar Crashlytics?

    • Obtén alertas de errores en tiempo real.
    • Analiza informes de errores detallados con agrupación automática de problemas.
    • Monitorea errores críticos para mantener las aplicaciones estables.
  • Requisitos de configuración:

    • Instala Node.js (v16+), Capacitor (v4+), y herramientas como Xcode 14+ y Android Studio Electric Eel.
    • Descargar Firebase archivos de configuración (GoogleService-Info.plist para iOS, google-services.json para Android).
    • Actualice archivos específicos de plataforma como Podfile (iOS) y build.gradle (Android).
  • Pasos clave:

    • Instale Crashlytics:

      npm install @capgo/capacitor-firebase-crashlytics && npx cap sync
    • Inicie Crashlytics en su aplicación:

      import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
      await FirebaseCrashlytics.initialize();
  • Pruebe su configuración:

    • Desencadene un crash de prueba:

      await FirebaseCrashlytics.crash();
  • Consejo adicional: Combine Crashlytics con Capgo para actualizaciones en vivo instantáneas sin retrasos de la tienda de aplicaciones.

Esta guía garantiza que tu aplicación sea ininterrumpida y amigable para el usuario. Comienza configurando Firebase Crashlytics hoy mismo!

Guía de Android 2021: Firebase Crashlytics - errores de … personalizados

Firebase Crashlytics

Requisitos de configuración

Antes de sumergirte, asegúrate de haber completado los siguientes pasos:

Herramientas y cuentas requeridas

Deberás instalar lo siguiente:

  • Node.js (v16 o superior) y Capacitor (v4 o superior)
  • A cuenta de Firebase con un proyecto activo
  • Xcode 14+ para el desarrollo de iOS
  • Android Studio Electric Eel o una versión más reciente para el desarrollo de Android
  • La última versión de CocoaPods (requerido para iOS)

Archivos de Configuración de la Plataforma

Para iOS:

  • Descargar el GoogleService-Info.plist archivo desde la Consola de Firebase.
  • Actualizar tu Podfile para incluir dependencias de Crashlytics.
  • Agregar las claves de privacidad necesarias a tu Info.plist archivo.

Para Android:

  • Obtener el google-services.json archivo desde la Consola de Firebase.
  • Hacer cambios en tanto el nivel de proyecto como el nivel de aplicación build.gradle archivos.
  • Actualizar el AndroidManifest.xml para incluir los permisos requeridos.

Firebase Configuración del Console de Firebase

Panel de control de la plataforma de Firebase

Configura Firebase y habilita Crashlytics siguiendo estos pasos:

  1. Crear un proyecto de Firebase y habilitar Crashlytics.

  2. Registra tus aplicaciones en la consola de Firebase:

    • Utiliza el ID de la caja para iOS y el nombre del paquete para Android.
    • Descargar los archivos de configuración: GoogleService-Info.plist (iOS) y google-services.json (Android).
  3. Integrar SDKs de Firebase en tu aplicación agregando estas dependencias:

    Para Android (nivel de aplicación build.gradle):

    dependencies {
        implementation platform('com.google.firebase:firebase-bom:32.0.0')
        implementation 'com.google.firebase:firebase-crashlytics'
        implementation 'com.google.firebase:firebase-analytics'
    }

    Para iOS (Podfile):

    pod 'Firebase/Crashlytics'
    pod 'Firebase/Analytics'

Una vez que hayas completado estos pasos, estás listo para pasar a la sección de instalación de plugins.

Pasos de Instalación

Instalación de Plugin

Primero, instale el plugin y sincrónelo con Capacitor:

npm install @capgo/capacitor-firebase-crashlytics && npx cap sync

Luego, inicialice Crashlytics en su aplicación. Agregue los siguientes code a app.component.ts o main.ts:

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.initialize();

Configuración de Plataforma

Configure las configuraciones requeridas para las plataformas Android e iOS.

Configuración de Android

  1. Agregar el plugin de Crashlytics Gradle a su archivo de nivel de aplicación: build.gradle file:

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. Habilite la recopilación de errores en AndroidManifest.xml:

    <meta-data
        android:name="firebase_crashlytics_collection_enabled"
        android:value="true" />

Configuración de iOS

  1. Configura Firebase en AppDelegate.swift:

    import Firebase
    FirebaseApp.configure()

Prueba tu configuración

Confirma que Crashlytics está funcionando ejecutando un crash de prueba y revisando la Consola de Firebase:

  • Desencadena un crash de prueba con una clave personalizada:

    await FirebaseCrashlytics.setCustomKey({key: 'test_scenario', value: 'manual_crash'});
    await FirebaseCrashlytics.crash();
  • Opcionalmente, identifica a un usuario:

    await FirebaseCrashlytics.setUserId({userId: 'user123'});
  • Registra eventos personalizados:

    await FirebaseCrashlytics.log({message: 'Test crash triggered'});

Los informes, incluidos los rastros de pila, detalles del dispositivo y claves personalizadas, deberían aparecer en la Consola de Firebase dentro de unos 5 minutos.

Importante: Elimina las llamadas de crash antes de liberar tu aplicación. Para deshabilitar la recopilación de crash durante el desarrollo, utiliza:

await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});

Guía de Monitoreo

Una vez que hayas confirmado tu configuración con un crash de prueba, utiliza la Consola de Firebase para rastrear los crash y errores reales en tu aplicación en vivo.

Informes de Crashes

Puede encontrar informes de crash en la Consola de Firebase en la sección Crashlytics. Aquí está lo que verá:

  • Usuarios sin crash: La porcentaje de usuarios que no han experimentado crashes.
  • Estabilidad de la aplicación: Cómo a menudo ocurren los crashes.
  • Análisis de impacto: El número de usuarios afectados.

Haga clic en cualquier problema para profundizar en detalles como las trazas de pila, la información del dispositivo (por ejemplo, la versión del sistema operativo, la memoria), las claves personalizadas, los registros y el recorrido del usuario que llevó hasta el crash.

Consejo práctico: Active la característica de

Informes de Errores

  • Priorizar por Impacto: Enfócate en errores que afectan a más usuarios o que ocurren en partes críticas de tu aplicación. El seguimiento de tendencias puede ayudarte a identificar problemas urgentes.

  • Usar Claves Personalizadas: Agrega contexto a tus informes de errores con claves personalizadas. Por ejemplo:

    await FirebaseCrashlytics.setCustomKey({
      key: 'current_view',
      value: 'payment_processing'
    });
  • Grupos de Problemas Similar: Toma ventaja de la agrupación automática de problemas de Firebase. También puedes etiquetar errores relacionados con claves personalizadas consistentes y utilizar titulares claros y descriptivos para un seguimiento más fácil.

Proteger la Privacidad del Usuario

Para asegurar el cumplimiento y proteger los datos del usuario, sigue estas directrices:

  • Autorizaciones:

    • Menciona el informe de errores en tu política de privacidad.
    • Obtén el consentimiento del usuario para la recopilación de datos en regiones con regulaciones de GDPR.
    • Proporciona a los usuarios la opción de darse de baja de los informes de errores.
  • Controles de Recopilación de Datos:

    await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});
    await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true});
  • Retención de Datos:

    • Configura la eliminación automática de datos después de 90 días.
    • Elimina información sensible de tus informes.
    • Utiliza claves personalizadas no identificables para mantener la privacidad del usuario mientras depuras.

Capgo Integración

Capgo Panel de Control de Actualización en Vivo Interface

Mejora el proceso desde la detección de errores hasta la implementación de correcciones al pairar el sistema de actualización en vivo de Capgo con Crashlytics.

Sobre Capgo

Capgo es una herramienta de actualización en vivo diseñada específicamente para Capacitor aplicaciones. Con más de 1.900 aplicaciones en producción y un 95% de actualizaciones dentro de 24 horas, garantiza reparaciones rápidas sin las demoras de aprobaciones de tiendas de aplicaciones [1].

Características clave incluyen:

  • Cifrado de extremo a extremo para actualizaciones seguras
  • Reiniciación de clic único a versiones anteriores
  • Distribución basada en canales para lanzamientos dirigidos
  • Integración CI/CD sin problemas
  • A plataforma 100% de código abierto

Crashlytics y Capgo Juntos

Usando Crashlytics con Capgo crea un flujo de trabajo eficiente para identificar y resolver problemas rápidamente.

Aquí's cómo funciona:

  1. Detección y respuesta de errores
    Crashlytics identifica un error, y Capgo le permite desplegar correcciones de inmediato sin tener que esperar la aprobación de la tienda de aplicaciones.

  2. Actualizaciones dirigidas

    • : Prueba fijaciones con un grupo específico para asegurarse de que sean efectivas.Despliegue escalonado
    • : Despliega gradualmente actualizaciones para reducir riesgos.Solución de emergencia
    • : Envía parches críticos rápidamente para resolver problemas urgentes.Monitoreo y verificación
  3. Detección de errores y respuesta
    Después de desplegar actualizaciones con Capgo, utilice Crashlytics para rastrear las tasas de errores y confirmar que el problema está resuelto.

Seguridad y Reglas de la Tienda de Aplicaciones

Capgo cumple con las políticas de Apple y Google mientras proporciona características de seguridad fuertes:

  • Tasa de éxito global del 82% para entregar actualizaciones [1]
  • Control de versiones automático para una mejor organización
  • Cumplimiento con las directrices de actualizaciones en vivo de la tienda de aplicaciones

Para una integración segura con Crashlytics:

  • Habilite el seguimiento de errores en ambos sistemas.
  • Utilice las herramientas de monitoreo de Capgo junto con los informes de Crashlytics.
  • Mantenga el control de versiones para todas las actualizaciones.
  • Mantenga registros detallados de actualizaciones para fines de auditoría.

Continúe a la sección de opciones del plugin para explorar otras herramientas de actualizaciones en vivo.

Opciones del plugin

La elección del plugin adecuado para informar errores puede tener un gran impacto en cómo identificas y solucionas errores en tu aplicación.

Una comparación rápida de Crashlytics con otras herramientas populares de informe de errores para Capacitor:

  • Sentry: Ofrece un nivel gratuito con planes pagos que comienzan en $26/mes. Soporta más de 30 plataformas y proporciona monitoreo de errores en tiempo real con detalles.
  • Bugsnag: Comienza en $47/mes. Cubre tanto plataformas móviles como web, destacando agrupación automática de errores y seguimiento de versiones.
  • Rollbar: Se vende desde $31/mes. Funciona en varias plataformas, con características como seguimiento de despliegues y seguimiento de personas.

Crashlytics es especialmente atractivo para equipos que ya utilizan Firebase, gracias a su integración suave y un nivel gratuito.

Resumen

Una mirada rápida de lo que has logrado y lo que viene a continuación:

Resumen de los Pasos de Configuración

Has completado tres pasos clave para empezar:

  • Crear un proyecto de Firebase y registrar tus aplicaciones iOS/Android.
  • Instalar y configurar el plugin de Crashlytics.
  • Actualizar los archivos de plataforma iOS y Android necesarios.

¿Por qué Integrar Estas Herramientas?

Al pairar Firebase Crashlytics con Capgo obtienes un sistema poderoso para el seguimiento de errores y gestión de actualizaciones. Aquí tienes lo que este combo ofrece:

  • Soluciones rápidas: Aplicar actualizaciones instantáneas y revertir cambios con solo un clic.
  • Despliegues fiablesAsegúrese de que las actualizaciones sean ampliamente adoptadas y se entreguen de manera suave a los usuarios.

¿Qué sigue?

  1. Habilite análisis de errores detallados en la Consola de Firebase.
  2. Agregue Capgo a su pipeline de CI/CD para actualizaciones escalonadas.
  3. Utilice Capgo canales para probar y liberar arreglos paso a paso.

Con Crashlytics y Capgo en su lugar, está listo para mantener su aplicación funcionando de manera suave y mejorando con el tiempo.

Actualizaciones en vivo para aplicaciones Capacitor

Cuando un error en la capa web está activo, envíe la corrección a través de Capgo en lugar de esperar días para la aprobación de la tienda de aplicaciones. Los usuarios reciben la actualización en segundo plano mientras los cambios nativos siguen en el camino de revisión normal.

Comienza Ahora

Últimas noticias de nuestro Blog

Capgo le da las mejores perspectivas que necesita para crear una aplicación móvil verdaderamente profesional.