Zum Hauptinhalt springen

Firebase Crashlytics für Capacitor-Apps

Erfahren Sie, wie Sie eine Schritt-für-Schritt-Anleitung zum Einrichten von Crashlytics für iOS- und Android-Apps erstellen können, um Echtzeit-Fehlerrapporte in Ihre mobilen Apps zu integrieren.

Martin Donadieu

Martin Donadieu

Inhaltsmarketer

Firebase Crashlytics für Capacitor-Apps

Firebase Crashlytics Firebase Crashlytics hilft Ihnen, Anwendungsabstü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-Alarme für Anwendungsabstürze.
    • Analyse detaillierter Absturzberichte mit Automatische Gruppierung von Problemen.
    • Überwachen kritischer Fehler, um Anwendungen 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 zur Erreichung:

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

    • Auslösen Sie einen Testcrash:

      await FirebaseCrashlytics.crash();
  • Zusätzlicher Tipp: Combine Crashlytics mit Capgo Instantanen Live-Updates ohne Wartezeit im App-Store.

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

2021 Android-Leitfaden: Firebase Crashlytics - benutzerdefinierte Crash …

Firebase Crashlytics

Einstellungen

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

Plattformkonfigurationsdateien

Für iOS:

  • Laden Sie das GoogleService-Info.plist Datei von der Firebase-Konsole herunter.
  • Aktualisieren Sie Ihre Podfile um Crashlytics-Abhängigkeiten zu enthalten.
  • Fügen Sie die notwendigen Datenschutzschlüssel zu Ihrer Info.plist Datei hinzu.

Für Android:

  • Erhalten Sie das google-services.json Datei aus dem Firebase-Konsolen.
  • Machen Sie Änderungen an beiden Projekt- und Anwendungsdateien. build.gradle Update die
  • um die erforderlichen Berechtigungen zu enthalten. AndroidManifest.xml Firebase

Konsolen-Setup Firebase-Plattform-Dashboard

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

Erstellen Sie ein Firebase-Projekt

  1. und aktivieren Sie Crashlytics. __CAPGO_KEEP_0__

  2. Registrieren Sie Ihre Apps in der Firebase-Konsole:

    • Verwenden Sie den Bundle-ID für iOS und 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'

Sobald diese Schritte abgeschlossen sind, bist du bereit, zur Plugin-Installation zu wechseln.

Installationsanweisungen

Plugin-Installation

Zuerst installieren Sie das Plugin und synchronisieren Sie es mit Capacitor:

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

Dann initialisieren Sie Crashlytics in Ihrer App. Fügen Sie die folgenden code hinzu app.component.ts oder main.ts:

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

Plattformskonfiguration

Konfigurieren Sie die erforderlichen Einstellungen für die Android- und iOS-Plattformen.

Android-Einrichtung

  1. Fügen Sie das Crashlytics-Gradle-Plugin zu Ihrer App-Level-Datei hinzu: build.gradle Datei:

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. Aktivieren Sie 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()

Testen 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 Stackschritte, Geräteinformationen und benutzerdefinierter Schlüssel, sollten innerhalb von etwa 5 Minuten in der Firebase-Konsole erscheinen.

Wichtig: Bevor Sie Ihre App veröffentlichen, entfernen Sie Crash-Anrufe. Um die Crash-Sammlung während der Entwicklung zu deaktivieren, verwenden Sie:

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

Führer zur Überwachung

Sobald Sie Ihre Konfiguration mit einem Testcrash bestätigt haben, verwenden Sie das Firebase-Konsolen-Tool, um tatsächliche Crashs und Fehler in Ihrer live-App zu verfolgen.

Lesen von Crash-Berichten

Sie können Crash-Berichte im Firebase-Konsolen-Tool unter der Crashlytics-Sektion finden. Hier sehen Sie Folgendes:

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

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

Pro Tipp: Aktivieren Sie die Funktion „Geschwindigkeitswarnungen“, um benachrichtigt zu werden, wenn die Crashraten plötzlich steigen. Dies kann Ihnen helfen, Probleme zu beheben, bevor sie zu viele Benutzer beeinflussen.

Tipps zur Fehlerverwaltung

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

  • Verwenden Sie benutzerdefinierte Schlüssel: Fügen Sie Kontext zu Ihren Crashberichten hinzu, indem Sie benutzerdefinierte Schlüssel verwenden. 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 Crashes mit konsistenten benutzerdefinierten Schlüsseln markieren und klare, beschreibende Titel verwenden, um eine einfache Verfolgung zu ermöglichen.

Schutz der Benutzerdaten

Um die Einhaltung der Richtlinien und den Schutz der Benutzerdaten sicherzustellen, folgen Sie bitte diesen Richtlinien:

  • Zugriffsrechte:

    • Erwähnen Sie die Berichterstattung über Abstürze in Ihrer Datenschutzrichtlinie.
    • Erhalten Sie die Zustimmung der Nutzer für die Datenerfassung in Regionen mit GDPR-Regulierungen.
    • Bieten Sie den Nutzern die Möglichkeit, sich von der Berichterstattung über Abstürze abzumelden.
  • Datenerfassungssteuerung:

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

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

Capgo Integration

Capgo Live-Update-Dashboard-Interface

Vereinfachen Sie den Prozess von der Absturzdetection bis zur Fix-Veröffentlichung, indem Sie das Live-Update-System von Capgo mit Crashlytics kombinieren.

Über Capgo

Capgo ist ein Live-Update-Tool, das speziell für Capacitor-Appsentwickelt wurde. Mit über 1.900 Apps in Betrieb und einer Update-Rate von 95% innerhalb von 24 Stunden stellt es sichere Reparaturen ohne die Verzögerungen von App-Store-Zustimmungen sicher [1].

Hauptmerkmale umfassen:

  • End-to-End-Verschlüsselung für sichere Updates
  • Einzuklick-rollback zurück zu vorherigen Versionen
  • Kanalbasierte Verteilung für gezielte Releases
  • Störungsfreie CI/CD-Integration
  • A 100% offene-Quell-Plattform

Crashlytics und Capgo gemeinsam

Die Verwendung von Crashlytics mit Capgo ermöglicht eine effiziente Workflow zur schnellen Identifizierung und Lösung von Problemen.

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-Store zu deployen.

  2. Zielgerichtete Updates

    • : Testen Sie Fixes mit einer bestimmten Gruppe, um sicherzustellen, dass sie wirksam sind.Stufenweise Rollout
    • : Deployen Sie Updates allmählich, um Risiken zu reduzieren.beta testing
    • Notfall-Reparatur: Schnell pushen Sie kritische Patches, um dringende Probleme zu lösen.
  3. Überwachung und Verifizierung
    Nach der Bereitstellung von Updates mit Capgo verwenden Sie Crashlytics, um die Crash-Raten zu überwachen und bestätigen, dass das Problem gelöst ist.

Sicherheit und App-Store-Regeln

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

Zur sicheren Integration mit Crashlytics:

  • Aktivieren Sie die Fehlerüberwachung in beiden Systemen.
  • Verwenden Sie die Überwachungstools von Capgo neben den Berichten von Crashlytics.
  • Mithalten Sie die Versionskontrolle für alle Updates.
  • Halten Sie detaillierte Protokolle von Updates für Zwecke der Rechnungslegung auf.

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

Plugin-Optionen

Die Wahl des richtigen Fehlerberichtungsplugins kann erheblich Auswirkungen auf die Identifizierung und Behebung von Fehlern in Ihrer App haben.

Hier ist eine schnelle Vergleichsübersicht 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-Fehlerrückmeldung mit detailliertem Kontext.
  • Bugsnag: Ab 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

Hier ist ein schneller Überblick über das, was Sie erreicht haben, und was als Nächstes kommt:

Zusammenfassung der Einrichtungsschritte

Sie haben drei wichtige Schritte zur Einstellung abgeschlossen:

  • Sie haben ein Firebase-Projekt erstellt und Ihre iOS/Android-Anwendungen registriert.
  • Sie haben das Crashlytics-Plugin installiert und konfiguriert.
  • Sie haben die notwendigen iOS- und Android-Plattformdateien aktualisiert.

Warum diese Tools integrieren?

Das Kombinieren von Firebase Crashlytics mit Capgo bietet Ihnen ein mächtiges System für Fehlerüberwachung und Update-Management. Hier sind die Vorteile dieser Combo:

  • Schnellkorrekturen: Pushen Sie sofortige Updates und rufen Sie Änderungen mit nur einem Klick zurück.
  • Vertrauenswürdige Bereitstellungen: Stellen Sie sicher, dass Updates weit verbreitet und glatt an die Benutzer geliefert werden.

Was kommt als Nächstes?

  1. Aktivieren Sie detaillierte Fehleranalyse in der Firebase-Konsole.
  2. Fügen Sie Capgo Ihrem CI/CD-Pipeline hinzu, um Updates auf eine Ebene zu vereinfachen.
  3. Verwenden Sie Capgo Kanäle um Fehler und Korrekturen Schritt für Schritt zu testen und zu veröffentlichen.

Mit Crashlytics und Capgo sind Sie bereit, Ihre App so zu halten, dass sie reibungslos läuft und sich im Laufe der Zeit verbessert.

Fortsetzen Sie von Firebase Crashlytics für Capacitor Apps

Wenn Sie __CAPGO_KEEP_0__ Apps mit Firebase Crashlytics verwenden für die Capacitor-Anwendungen um native Plugin-Arbeit zu planen, verbinden Sie es mit Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen Capgo Native Builds für das Produktworkflow in Capgo Native Builds.

Live-Updates für Capacitor-Anwendungen

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

Los geht's jetzt

Neueste Beiträge aus unserem Blog

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