Zum Hauptinhalt springen

Firebase Crashlytics für Capacitor-Apps

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

Martin Donadieu

Martin Donadieu

Content-Marketing-Manager

Firebase Crashlytics für Capacitor-Apps

Firebase Crashlytics Hilft Ihnen dabei, Anwendungsstürze 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:

  • Warum Crashlytics verwenden?

    • Erhalten Echtzeit-Fehlerrufe.
    • Analytische Fehlberichte mit automatischer Problemgruppierung.
    • Kritische Fehler überwachen, um Apps stabil zu halten.
  • Setup-Anforderungen:

    • 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 plattform-spezifische Dateien wie Podfile (iOS) und build.gradle (Android).
  • Schritte:

    • Crashlytics installieren:

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

      import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
      await FirebaseCrashlytics.initialize();
  • Ihr Setup testen:

    • Bonus-Tipp:

      await FirebaseCrashlytics.crash();
  • Combine Crashlytics mit __CAPGO_KEEP_0__ Capgo Diese Anleitung stellt sicher, dass Ihre App fehlerfrei und benutzerfreundlich ist. Beginnen Sie mit der Einrichtung von Firebase Crashlytics heute!

Crashlytics und

2021 Android Leitfaden: Firebase Crashlytics - benutzerdefinierte Crash …

Firebase Crashlytics

Setupanforderungen

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

Benötigte Software und Konten

Sie müssen die folgenden installieren:

  • 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:

  • Laden Sie das GoogleService-Info.plist __CAPGO_KEEP_0__ von der Firebase-Konsole.
  • Aktualisieren Sie Ihr Podfile um Crashlytics-Abhängigkeiten zu enthalten.
  • Fügen Sie die erforderlichen Datenschutzschlüssel zu Ihrem Info.plist __CAPGO_KEEP_0__.

Für Android:

  • Erhalten Sie das google-services.json __CAPGO_KEEP_0__ von der Firebase-Konsole.
  • Machen Sie Änderungen an beiden Projekt- und Anwendungslevel- build.gradle __CAPGO_KEEP_0__.
  • Aktualisieren Sie die AndroidManifest.xml um die erforderlichen Berechtigungen zu enthalten.

Firebase Konsole-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 in der Firebase-Konsole:

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

    Für iOS ( 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'
    }

    Sobald diese Schritte abgeschlossen sind, sind Sie bereit, zur Plugin-Installation zu wechseln.Podfile):

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

Installationsanweisungen

__CAPGO_KEEP_0__

Plugin-Installation

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

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

Initialisiere dann Crashlytics in deiner App. Füge die folgenden code hinzu: app.component.ts oder main.ts:

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

Plattform-Konfiguration

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

Android-Einrichtung

  1. Füge das Crashlytics-Gradle-Plugin zu deiner App-Level- build.gradle Datei:

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. Aktiviere die Crashsammlung in 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

Stellen Sie sicher, 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();
  • Optional: Identifizieren Sie einen Benutzer:

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

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

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

Wichtig: Entfernen 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});

Überwachungsleitfaden

Sobald 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 finden Crashberichte im Firebase-Konsolen unter der Crashlytics-Sektion. Hier sehen Sie Folgendes:

  • Benutzer ohne Crashe: Der Prozentsatz der Benutzer, die keine Crashe erlebt haben.
  • Stabilitätsprobleme: Wie oft treten Crashe auf.
  • Auswirkungsanalyse: Die Anzahl der betroffenen Benutzer.

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

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

Tipps zur Fehlerverwaltung

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

  • Benutzerdefinierte Schlüssel verwenden: Fügen Sie Kontext zu Ihren Fehlerberichten hinzu, indem Sie benutzerdefinierte Schlüssel verwenden. Zum Beispiel:

    await FirebaseCrashlytics.setCustomKey({
      key: 'current_view',
      value: 'payment_processing'
    });
  • Ähnliche Probleme gruppieren: 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.

Benutzerdatenschutz

Um die Einhaltung sicherzustellen und 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 abzumelden.
  • Datenverarbeitungskontrollen:

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

    • Stellen Sie die automatische Löschung von Daten nach 90 Tagen ein.
    • Reinigen Sie sensible Informationen aus Ihren Berichten.
    • Verwenden Sie nicht identifizierbare benutzerdefinierte Schlüssel, um die Benutzerprivatsphäre während der Debugging-Phase aufrechtzuerhalten.

Capgo Integration

Capgo Live-Update-Dashboard-Interface

Vereinfachen Sie den Prozess von Crash-Detektion bis Fix-Deploy durch das Paaren des Live-Update-Systems von Capgo mit Crashlytics.

Über Capgo

Capgo ist ein Live-Update-Tool, das speziell für Capacitor-Apps. Mit über 1.900 Apps in Produktionsumfeld und einer 95%igen Aktualisierungsrate innerhalb von 24 Stunden stellt es sichergestellt, dass schnelle Reparaturen ohne die Verzögerungen von App-Store-Bewilligungen durchgeführt werden können [1].

Hauptmerkmale umfassen:

  • End-to-End-Verschlüsselung für sichere Updates
  • Ein-Klick-Rollback zurück zu vorherigen Versionen
  • Kanalbasierte Verteilung für gezielte Releases
  • Schlüssellochfreie CI/CD-Integration
  • Ein 100% offene-Quell-Plattform

Crashlytics und Capgo Zusammen

Mit Crashlytics und Capgo können Sie eine effiziente Arbeitsweise für die Identifizierung und Behebung von Problemen schnell schaffen.

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 des App-Stores bereitzustellen.

  2. Zielgerichtete Updates

    • Beta-Testen: Testen Sie Fixes mit einer bestimmten Gruppe, um sicherzustellen, dass sie wirksam sind.
    • Stufenweise Bereitstellung: Führen Sie Updates allmählich aus, um Risiken zu reduzieren.
    • Notfall-Fix: Drücken Sie kritische Patches schnell aus, um dringende Probleme zu lösen.
  3. Überwachung und Verifizierung
    After Capgo-Bereitstellung aktualisieren, verwenden Sie Crashlytics, um die Crash-Raten zu überwachen und bestätigen, dass das Problem gelöst ist.

Sicherheit und App Store-Richtlinien

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

  • 82% globale Erfolgsrate bei der Bereitstellung 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.
  • Versionenkontrolle für alle Updates aufrechterhalten.
  • Detailsprotokolle von Updates für Audit-Zwecke führen.

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

Plugin Einstellungen

Die Wahl des richtigen Fehlerberichtungsplugins kann erheblich Einfluss darauf haben, wie Sie Fehler in Ihrer App identifizieren und beheben.

Ein schneller Vergleich von Crashlytics mit anderen beliebten Fehlerberichtungs-Tools 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: Preislich 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 darauf, was Sie erreicht haben und was als Nächstes kommt:

Setup-Schritte-Zusammenfassung

Sie haben drei wichtige Schritte abgeschlossen, um loszulegen:

  • Einen Firebase-Projekt erstellt und Ihre iOS/Android-Anwendungen registriert.
  • Die Crashlytics-Plugin installiert und konfiguriert.
  • Die notwendigen iOS- und Android-Plattformdateien aktualisiert.

Warum diese Tools integrieren?

Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and __CAPGO_KEEP_0__-Verwaltung. Hier sind die Vorteile dieses Combos:

  • Schnelle Reparaturen: Pushen Sie sofortige Updates und rufen Sie Änderungen mit nur einem Klick zurück.
  • Vertrauenswürdige 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 deinem CI/CD-Pipeline hinzu, um Updates auf eine Ebene zu vereinfachen.
  3. Verwende Capgo-Kanäle um Fehler und Fixes Schritt für Schritt zu testen und freizugeben.

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

Fortsetzung von Firebase Crashlytics für Capacitor Apps

Wenn du Firebase Crashlytics für __CAPGO_KEEP_0__ Apps verwendest Firebase Crashlytics for Capacitor Apps Firebase Crashlytics for __CAPGO_KEEP_0__ Apps Capgo Plugin Directory für den Produktworkflow in Capgo Plugin Directory Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren Alternativen zu Ionic Enterprise Plugins für den Produktworkflow in Alternativen zu Ionic Enterprise Plugins und Capgo Native Builds für den Produktworkflow in Capgo Native Builds.

Live-Updates für Capacitor Apps

Wenn ein Fehler im Web-Schicht lebt, liefern Sie die Reparatur über Capgo anstatt Tage zu warten, bis die App-Store-Zulassung genehmigt ist. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Verfahren bleiben.

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.