Saltar al contenido principal

Firebase Crashlytics para Capacitor Aplicaciones

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

Martin Donadieu

Martin Donadieu

Gerente de Contenido

Firebase Crashlytics para Capacitor Aplicaciones

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

  • ¿Por qué usar Crashlytics?

    • Obtén real-time alerts de rechazo.
    • Analyze informes de rechazo detallados con agrupación de problemas automatizada.
    • Monitorear errores críticos para mantener aplicaciones estables.
  • Requisitos de configuración:

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

    • Instalar Crashlytics:

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

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

    • Desencadena un crash de prueba:

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

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

Guía de 2021 para Android: Firebase Crashlytics - crash de … personalizado

Firebase Crashlytics

Requisitos de configuración

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

Software y cuentas requeridas

Necesitarás instalar lo siguiente:

  • Node.js (v16 o superior) y Capacitor (v4 o superior)
  • Una 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 Plataforma

Para iOS:

  • Descargue el GoogleService-Info.plist archivo desde la Consola de Firebase.
  • Actualice su 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 archivo de nivel de proyecto como el archivo de nivel de aplicación. build.gradle Actualizar el
  • para incluir los permisos requeridos. AndroidManifest.xml Configuración de

Console de Firebase Setup Console de Firebase

Plataforma de Firebase de la consola

Configura Firebase y habilita Crashlytics siguiendo estos pasos:

  1. Crea un proyecto de Firebase y habilita Crashlytics.

  2. Registra tus aplicaciones en la consola de Firebase:

    • Utiliza el identificador de paquete para iOS y el nombre de paquete para Android.
    • Descarga los archivos de configuración: GoogleService-Info.plist (iOS) y google-services.json (Android).
  3. Integra los 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 completados estos pasos, estás listo para pasar a la sección de instalación de plugins.

Pasos de instalación

Instalación de plugins

Luego, sincroniza el plugin con tus plataformas nativas y ve el @capgo/capacitor-firebase-crashlytics página del plugin para la referencia completa de API:

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

Entonces, inicialice Crashlytics en su aplicación. Agregue el siguiente code a app.component.ts o main.ts:

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

Configuración de la Plataforma

Configure las configuraciones requeridas para las plataformas Android e iOS.

Configuración de Android

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

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

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

Configuración de iOS

  1. Configure Firebase en AppDelegate.swift:

    import Firebase
    FirebaseApp.configure()

Prueba de Configuración

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

  • Desencadenar un testeo de crash 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 el Console 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 testeo de crash, utiliza el Console de Firebase para rastrear los crash y errores reales en tu aplicación en vivo.

Lectura de Informes de Crash

Puedes encontrar informes de crash en el Console de Firebase en la sección Crashlytics. Aquí es lo que verás:

  • Usuarios sin crash : El porcentaje de usuarios que no han experimentado crash.
  • Estabilidad de problemas: ¿Cuántas veces ocurren los errores.
  • Análisis de impacto: El número de usuarios afectados.

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

Consejo práctico: Active la característica de “alertas de velocidad” para recibir notificaciones cuando los índices de errores aumenten repentinamente. Esto puede ayudarlo a abordar problemas antes de que afecten a demasiados usuarios.

Consejos de Gestión de Errores

  • Priorizar por Impacto: Enfóquese en errores que afecten a más usuarios o ocurran en partes críticas de su aplicación. El seguimiento de tendencias puede ayudarlo a identificar problemas urgentes.

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

    await FirebaseCrashlytics.setCustomKey({
      key: 'current_view',
      value: 'payment_processing'
    });
  • Grupo de Problemas Similares: Aprovecha el agrupamiento automático de problemas de Firebase. También puedes etiquetar problemas relacionados con claves de llave personalizada consistente y utilizar titulares claros y descriptivos para un seguimiento más fácil.

Protegiendo la Privacidad del Usuario

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

  • Permisos:

    • 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 la informe de errores.
  • Controles de Recopilación de Datos:

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

    • Establece la eliminación automática de datos después de 90 días.
    • Limpia la información sensible de tus informes.
    • Use claves personalizadas no identificables para mantener la privacidad del usuario mientras se depura.

Capgo Integración

Capgo Dashboard de Actualización en Vivo de la Interface

Mejore el proceso desde la detección de errores hasta la implementación de correcciones al asociar 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 aplicaciones Capacitor. Con más de 1.900 aplicaciones en producción y un 95% de actualización dentro de las 24 horas, garantiza correcciones rápidas sin los retrasos de aprobaciones de tiendas de aplicaciones [1].

Características clave incluyen:

  • Encriptación de extremo a extremo para actualizaciones seguras
  • Una retroalimentación de un solo clic a versiones anteriores
  • Distribución basada en canales para lanzamientos dirigidos
  • Integración CI/CD sin problemas
  • A Una plataforma 100% de código abierto

Crashlytics y Capgo Juntos

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

Aquí está cómo funciona:

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

  2. Actualizaciones Dirigidas

    • Pruebas de Beta: Realiza pruebas con un grupo específico para asegurarte de que funcionan correctamente.
    • Despliegue Etapa: Despliega gradualmente actualizaciones para reducir riesgos.
    • Solución de Emergencia: Aplica parches críticos rápidamente para resolver problemas urgentes.
  3. Monitoreo y Verificación
    : Después de desplegar actualizaciones con Capgo, utiliza Crashlytics para rastrear las tasas de errores y confirmar que el problema se ha 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 sólidas:

  • 82% de tasa de éxito global para entregar actualizaciones [1]
  • Control de versiones automático para una mejor organización
  • Cumplimiento con las directrices de actualización en vivo de las tiendas 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.
  • Conservar registros detallados de actualizaciones con fines de auditoría.

Siga a la sección de opciones del plugin para explorar otras herramientas de actualización en vivo.

Opciones del plugin

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

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

  • Sentry: Ofrece un nivel gratuito con planes pagos a partir de $26/mes. Soporta más de 30 plataformas y proporciona un seguimiento de errores en tiempo real con contexto detallado.
  • Bugsnag: Comienza a $47/mes. Cubre tanto plataformas móviles como web, con características como agrupación automática de errores y seguimiento de lanzamientos.
  • Rollbar: Precio 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

Aquí tienes una mirada rápida de lo que has logrado y lo que viene a continuación:

Recapitulación de los Pasos de Configuración

Haz completado tres pasos clave para empezar:

  • Creaste un proyecto de Firebase y registraste tus aplicaciones iOS/Android.
  • Instalaste y configuraste el plugin de Crashlytics.
  • Updated the necessary iOS and Android platform files.

¿Por qué integrar estas herramientas?

Al pairar Firebase Crashlytics con Capgo obtienes un poderoso sistema para el seguimiento de errores y gestión de actualizaciones. Aquí está lo que ofrece esta combinación:

  • Soluciones rápidas: Envía actualizaciones instantáneas y vuelve a implementar cambios con solo un clic.
  • Despliegues confiables: Asegúrate de que las actualizaciones sean ampliamente adoptadas y se entreguen de manera suave a los usuarios.

¿Qué sigue?

  1. Activa las análisis de errores detallados en la Consola de Firebase.
  2. Agrega Capgo a tu pipeline de CI/CD para actualizaciones más fluidas.
  3. Usa Capgo canales para probar y liberar arreglos paso a paso.

Con Crashlytics y Capgo en funcionamiento, estás listo para mantener tu aplicación funcionando suavemente y mejorando con el tiempo.

Sigue adelante desde Firebase Crashlytics para Capacitor Apps

Si estás utilizando Firebase Crashlytics para Capacitor Apps para planificar el trabajo de plugin nativo, conecta con Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise, y Capgo Compilación Nativa para el flujo de trabajo del producto en Capgo Compilación Nativa.

Actualizaciones en vivo para aplicaciones Capacitor

Cuando haya un error de capa web en vivo, 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 obtienen 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 te da las mejores perspectivas que necesitas para crear una aplicación móvil verdaderamente profesional.