Zum Hauptinhalt springen

Firebase Crashlytics für Capacitor-Anwendungen

Erhalten Sie einen Schritt-für-Schritt-Leitfaden, um eine Echtzeit-Crash-Reporting-Integration in Ihre mobilen Anwendungen einzuführen, einschließlich der Einrichtung von Crashlytics für iOS- und Android-Anwendungen.

Martin Donadieu

Martin Donadieu

Inhaltsmarketer

Firebase Crashlytics für Capacitor-Anwendungen

Firebase Crashlytics Hilft Ihnen dabei, Anwendungsfehler in Echtzeit zu verfolgen und bietet detaillierte Berichte, um Probleme schnell zu beheben. Es integriert sich reibungslos mit Capacitor Für beide iOS- und Android-Apps. Hier ist, was Sie wissen müssen:

  • Wozu Crashlytics?

    • Erhalten echte Echtzeit-Fehlstartmeldungen.
    • Analyse detaillierter Fehlstartberichte mit automatischer Problemlösung.
    • Überwachen kritischer Fehler, um Apps stabil zu halten.
  • Einstellungsvoraussetzungen:

    • Installieren Node.js (v16+), Capacitor (v4+), und Werkzeuge wie Xcode 14+ und Android Studio Electric Eel.
    • Herunterladen Firebase Konfigurationsdateien (GoogleService-Info.plist für iOS, google-services.json für Android).
    • Aktualisieren Sie plattformabhängige Dateien wie Podfile iOS) und build.gradle (Android).
  • Schritte zur Sicherstellung:

    • Installieren Sie Crashlytics:

      npm install @capgo/capacitor-firebase-crashlytics && npx cap sync
    • Initialisieren Sie Crashlytics in Ihrer App:

      import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
      await FirebaseCrashlytics.initialize();
  • Testen Sie Ihre Konfiguration:

    • Einen Testcrash auslösen:

      await FirebaseCrashlytics.crash();
  • Bonus-Tipp: Combine Crashlytics mit Capgo zur sofortigen Live-Übermittlung ohne Verzögerung durch den App-Store.

Dieses Leitfaden stellt sicher, dass Ihre App fehlerfrei und benutzerfreundlich ist. Beginnen Sie mit der Einrichtung von Firebase Crashlytics heute!

2021 Android Guide: Firebase Crashlytics - benutzerdefinierte Fehler …

Firebase Crashlytics

Setup-Anforderungen

Bevor Sie fortfahren, stellen Sie sicher, dass Sie die folgenden Schritte abgeschlossen haben:

Erforderliche Software und Konten

Sie benötigen Folgendes:

  • Node.js (v16 oder höher) und Capacitor (v4 oder höher)
  • A Ein Firebase-Konto mit einem aktiven Projekt
  • Xcode 14+ für die iOS-Entwicklung
  • Android Studio Electric Eel oder eine neuerere Version für die Android-Entwicklung
  • Die neueste Version von CocoaPods erforderlich für iOS

Plattform-Konfigurationsdateien

Für iOS:

  • Herunterladen Sie das GoogleService-Info.plist Datei aus dem Firebase-Konsolen.
  • Aktualisieren Sie Ihre Podfile um Crashlytics-Abhängigkeiten zu beinhalten.
  • Fügen Sie die erforderlichen Datenschutzschlüssel in Ihre Info.plist Datei hinzu.

Für Android:

  • Erhalten Sie die google-services.json Datei aus dem Firebase-Konsolen.
  • Ändern Sie sowohl die Projekt- als auch die Anwendungs-Ebene build.gradle Dateien.
  • Aktualisieren Sie das AndroidManifest.xml um die erforderlichen Berechtigungen zu enthalten.

Firebase Console-Einrichtung

Firebase-Plattform-Dashboard

Konfigurieren Sie Firebase und aktivieren Sie Crashlytics über diese Schritte:

  1. Erstellen Sie ein Firebase-Projekt und aktivieren Sie Crashlytics.

  2. Registrieren Sie Ihre Apps im Firebase-Console:

    • Verwenden Sie den Bundle-Id für iOS und das den Paketnamen für Android.
    • Herunterladen Sie die Konfigurationsdateien: GoogleService-Info.plist (iOS) und google-services.json (Android).
  3. Integrieren Sie die Firebase-SDKs in Ihre App, indem Sie diese Abhängigkeiten hinzufügen:

    Für Android (App-Ebene 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'
    }

    Für iOS (Podfile):

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

Wenn diese Schritte abgeschlossen sind, sind Sie bereit, zur Plugin-Installation zu wechseln.

Installationsanweisungen

Plugin-Installation

Dann synchronisiere das Plugin mit deinen nativen Plattformen und sieh dir die @capgo/capacitor-firebase-crashlytics Plugin-Seite für die vollständige API-Dokumentation:

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

Dann initialisiere Crashlytics in deiner App. Füge den folgenden code hinzu app.component.ts oder main.ts:

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

HTML-Textfragment aus einer längeren Capgo-UI-Zeichenfolge (Elternschlüssel `alternatives_cta_questions`). Seite/Bereich: Capacitor-Live-Update-Vergleichsseite. Rolle: Langer Marketing- oder Rechtsparagraph. Gesehen in: Seite alternatives.astro. Produkt/Marken- und Entwicklertitel von Capgo beibehalten. Nachrichtenschlüssel `alternatives_cta_questions` (Alternativen-CTA-Fragen). | HTML-Textfragment aus einer längeren Capgo-UI-Zeichenfolge (Elternschlüssel `appflow_cta_questions`). Seite/Bereich: Appflow-Vergleichs- und Migration-Marketing-Kopie. Rolle: Langer Marketing- oder Rechtsparagraph. Gesehen in: Seite ionic-appflow.astro. Produkt/Marken- und Entwicklertitel von Capgo beibehalten. Nachrichtenschlüssel `appflow_cta_questions` (Appflow-CTA-Fragen). | HTML-Textfragment aus einer längeren Capgo-UI-Zeichenfolge (Elternschlüssel `capwesome_cta_questions`). Seite/Bereich: Capawesome-Vergleichsseite. Rolle: Langer Marketing- oder Rechtsparagraph. Gesehen in: Seite capwesome.astro. Produkt/Marken- und Entwicklertitel von Capgo beibehalten. Nachrichtenschlüssel `capwesome_cta_questions` (Capwesome-CTA-Fragen). | HTML-Textfragment aus einer längeren Capgo-UI-Zeichenfolge (Elternschlüssel `consulting_faq_subtitle`). Seite/Bereich: Beratungsdienste-Seite. Rolle: Abschnittstitel oder Slogan. Gesehen in: Seite consulting.astro. Produkt/Marken- und Entwicklertitel von Capgo beibehalten. Nachrichtenschlüssel `consulting_faq_subtitle` (Beratungsdienste-Frage-Untertitel). | Seite/Bereich: Appflow-Vergleichs- und Migration-Marketing-Kopie. Rolle: Kurzer UI-Label oder Navigationselement. Gesehen in: Seite ionic-appflow.astro, Seite ionic-enterprise-plugins.astro, Seite solutions/ionic-enterprise-plugins.astro. Nachrichtenschlüssel `appflow_plugins_or` (Appflow-Plugins-oder).

Plattform-Konfiguration

Stelle die erforderlichen Konfigurationen für die Android- und iOS-Plattformen ein.

  1. Android-Konfiguration build.gradle Füge das Crashlytics-Gradle-Plugin zu deinem App-Level-

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. Datei ein: «Füge das Crashlytics-Gradle-Plugin zu deinem App-Level-Datei ein: » AndroidManifest.xml:

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

iOS-Einrichtung

  1. Konfigurieren Sie Firebase in AppDelegate.swift:

    import Firebase
    FirebaseApp.configure()

Überprüfen Sie Ihre Einrichtung

Bestätigen Sie, dass Crashlytics funktioniert, indem Sie einen Testcrash auslösen und die Firebase-Konsole überprüfen:

  • Auslösen Sie einen Testcrash mit einem benutzerdefinierten Schlüssel:

    await FirebaseCrashlytics.setCustomKey({key: 'test_scenario', value: 'manual_crash'});
    await FirebaseCrashlytics.crash();
  • Optionell, identifizieren Sie einen Benutzer:

    await FirebaseCrashlytics.setUserId({userId: 'user123'});
  • Loggen Sie benutzerdefinierte Ereignisse:

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

Berichte, einschließlich Stack-Tracks, Geräteinformationen und benutzerdefinierter Schlüssel, sollten innerhalb von etwa 5 Minuten in der Firebase-Konsole erscheinen.

Wichtig: Löschen Sie Crash-Aufrufe, bevor Sie Ihre App veröffentlichen. Um die Crash-Sammlung während der Entwicklung zu deaktivieren, verwenden Sie:

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

Führer zur Überwachung

Nachdem Sie Ihre Einrichtung mit einem Testcrash bestätigt haben, verwenden Sie die Firebase-Konsole, um tatsächliche Crashes und Fehler in Ihrer Live-App zu verfolgen.

Crashberichte lesen

Sie können Crashberichte im Firebase-Console unter der Crashlytics-Sektion finden. Hier sehen Sie Folgendes:

  • Benutzer ohne Fehler: Der Prozentsatz der Benutzer, die keine Fehler erlebt haben.
  • Stabilitätsprobleme: Wie oft treten Fehler auf.
  • Analyse des Auswirkungen: Die Anzahl der betroffenen Benutzer.

Klicken Sie auf jede Problematik, um tiefer in Details wie Stapelspuren, Geräteinformationen (z.B. Betriebssystemversion, Speicher), benutzerdefinierte Schlüssel, Protokolle und die Reise des Benutzers, die zum Fehler führte, zu kommen.

Pro-Tipp: Aktivieren Sie die 'Geschwindigkeitswarnungen'-Funktion, um benachrichtigt zu werden, wenn die Fehlerraten plötzlich steigen. Dies kann Ihnen helfen, Probleme zu lösen, bevor sie zu viele Benutzer beeinträchtigen.

Tipp zur Fehlerverwaltung

  • Priorisieren Sie nach Auswirkung: Konzentrieren Sie sich auf Fehler, die am meisten Benutzer betreffen oder in kritischen Teilen Ihrer App auftreten. Die Analyse von Trends hilft Ihnen dabei, dringende Probleme zu identifizieren.

  • Verwenden Sie benutzerdefinierte Schlüssel: Fügen Sie Kontext zu Ihren Fehlerberichten mit benutzerdefinierten Schlüsseln hinzu. Zum Beispiel:

    await FirebaseCrashlytics.setCustomKey({
      key: 'current_view',
      value: 'payment_processing'
    });
  • Gruppieren Sie ähnliche Probleme: Nutzen Sie die automatische Gruppierung von Problemen durch Firebase. Sie können auch verwandte Fehler mit konsistenten benutzerdefinierten Schlüsseln markieren und klare, beschreibende Titel verwenden, um eine einfache Verfolgung zu ermöglichen.

Schutz der Benutzerdaten

: Um die Einhaltung sicherzustellen und die Benutzerdaten zu schützen, folgen Sie diesen Richtlinien:

  • Zustimmung:

    • : Erwähnen Sie die Fehlerberichterstattung in Ihrer Datenschutzrichtlinie.
    • Erhalten Sie die Zustimmung der Benutzer für die Datenerfassung in Regionen mit GDPR-Regulierungen.
    • Bieten Sie den Benutzern die Möglichkeit, sich von der Fehlerberichterstattung auszuschließen.
  • Datenerfassungssteuerungen:

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

    • Stellen Sie die automatische Löschung von Daten nach 90 Tagen ein.
    • Entfernen Sie sensitive Informationen aus Ihren Berichten.
    • Verwenden Sie nicht identifizierbare benutzerdefinierte Schlüssel, um die Benutzerprivatsphäre bei der Fehlersuche aufrechtzuerhalten.

Capgo Integration

Capgo Live Update Dashboard Interface

Erleichtern Sie den Prozess von Crash-Detektion bis Fix-Deployment, indem Sie das Live-Update-System von Capgo mit Crashlytics kombinieren.

Über Capgo

Capgo ist ein Live-Update-Tool, das speziell für Capgo-Anwendungen entwickelt wurde. Capacitor-Anwendungen. Mit über 1.900 Apps in Produktionsumfeld und einer 95%igen Aktualisierungsrate innerhalb von 24 Stunden stellt es sicher, dass schnelle Reparaturen ohne die Verzögerungen von Genehmigungen der App-Stores möglich sind [1].

Hauptmerkmale umfassen:

  • End-to-end-Verschlüsselung sichere Aktualisierungen
  • Einfache Rückkehr zu vorherigen Versionen
  • Kanalbasierte Verteilung für gezielte Releases
  • Einfache CI/CD-Integration
  • Ein 100% offenes Plattform Crashlytics und __CAPGO_KEEP_0__ Zusammen

Crashlytics und Capgo Zusammen

Mit Capgo und Crashlytics wird eine effiziente Arbeitsweise für die Identifizierung und Behebung von Problemen schnell geschaffen.

Hier ist, wie es funktioniert:

  1. Crash-Detektion und -Reaktion
    Crashlytics erkennt einen Crash, und Capgo ermöglicht Ihnen, Fixes sofort ohne Wartezeit auf die Genehmigung durch die App-Store-Verwaltung bereitzustellen.

  2. Zielgerichtete Updates

    • Zielgerichtete UpdatesZielgerichtete Updates
    • Zielgerichtete UpdatesZielgerichtete Updates
    • Zielgerichtete UpdatesZielgerichtete Updates
  3. Zielgerichtete Updates
    Nachdem Capgo-Updates bereitgestellt wurden, verwenden Sie Crashlytics, um die Crashraten zu überwachen und bestätigen, dass das Problem behoben ist.

Sicherheit und App Store-Richtlinien

Capgo entspricht den Richtlinien von Apple und Google und bietet starke Sicherheitsfunktionen:

  • 82% globale Erfolgsrate bei der Lieferung von Updates [1]
  • Automatische Versionskontrolle für eine bessere Organisation
  • Einhaltung der Richtlinien für Live-Updates in den App-Stores

Für eine sichere Integration mit Crashlytics:

  • Error-Tracking in beiden Systemen aktivieren.
  • Verwenden Sie die Überwachungstools von Capgo neben den Crashlytics-Berichten.
  • Behalten Sie die Versionskontrolle für alle Updates bei.
  • Halten Sie detaillierte Protokolle von Updates für Audit-Zwecke auf.

Fortsetzen Sie zur Plugin-Optionen-Sektion, um weitere Live-Update-Tools zu erkunden.

Plugin-Optionen

Wählen Sie den richtigen Plugin für Fehlerberichterstattung, um die Fehleridentifizierung und -behebung in Ihrer App erheblich zu verbessern.

Ein schneller Vergleich von Crashlytics mit anderen beliebten Werkzeugen für Fehlerberichterstattung für Capacitor:

  • Sentry: Bietet eine kostenlose Ebene mit bezahlten Plänen ab 26 €/Monat. Unterstützt über 30 Plattformen und bietet Echtzeit-Fehlerüberwachung mit detaillierten Kontexten.
  • Bugsnag: Startet bei 47 €/Monat. Umfasst sowohl mobile als auch Web-Plattformen, mit automatischer Fehlergruppierung und Release-Tracking.
  • Rollbar: Ab 31 €/Monat. Funktioniert auf mehreren Plattformen, mit Funktionen wie Deployment-Tracking und Person-Tracking.

Crashlytics ist besonders attraktiv für Teams, die bereits Firebase verwenden, dank seiner glatten Integration und einer kostenlosen Ebene.

Zusammenfassung

: Ein schneller Blick auf das, was Sie erreicht haben, und was als Nächstes kommt:

Zusammenfassung der Einrichtungsschritte

Sie haben drei wichtige Schritte abgeschlossen, um loszulegen:

  • Erstellt ein Firebase-Projekt und registriert Ihre iOS/Android-Anwendungen.
  • Installiert und konfiguriert die Crashlytics-Plugin.
  • Aktualisiert die notwendigen iOS- und Android-Plattformdateien.

Warum diese Tools integrieren?

Die Kombination von Firebase Crashlytics mit Capgo bietet ein mächtiges System für Fehlerüberwachung und Update-Verwaltung. Hier sind die Vorteile dieser Combo:

  • Schnelle Reparaturen: Pushen Sie sofortige Updates und rufen Sie Änderungen mit nur einem Klick zurück.
  • Verlässliche Rollouts: Stelle sicher, dass Updates weit verbreitet und reibungslos an die Benutzer gelangen.

Was kommt als Nächstes?

  1. Aktiviere detaillierte Fehleranalyse in der Firebase-Konsole.
  2. Füge Capgo in deinem CI/CD-Pipeline hinzu, um Updates flüssig zu liefern.
  3. Verwende Capgo-Kanäle um Fehler und Fixes Schritt für Schritt zu testen und zu veröffentlichen.

Mit Crashlytics und Capgo in der Hand bist du bereit, deine App reibungslos und kontinuierlich zu verbessern.

Weiter mit Firebase Crashlytics für Capacitor-Apps

Wenn du Firebase Crashlytics für __CAPGO_KEEP_0__-Apps verwendest, um native Plugin-Arbeit zu planen, verbinde es mit Firebase Crashlytics für Capacitor-Apps um native Plugin-Arbeit zu planen, verbinde es mit Capgo Plugin Directory zur Produktionsablauf in Capgo Plugin Directory Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo Hinzufügen oder Aktualisieren von Plugins zur Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins Ionische Enterprise-Plugin-Alternativen zur Produktionsablauf in Ionische Enterprise-Plugin-Alternativen, und Capgo Native Builds zur Produktionsablauf in Capgo Native Builds.

Live-Updates für Capacitor-Apps

Wenn ein Web-Schicht-Bug live ist, versenden Sie die Reparatur über Capgo anstatt Tage für die Genehmigung des App-Store zu warten. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Verfahren bleiben.

Menschliche Unterstützung von Martin

Los geht's jetzt

Neuestes aus unserem Blog

Capgo gibt Ihnen die besten Einblicke, die Sie benötigen, um eine wirklich professionelle mobile App zu erstellen.