Zum Hauptinhalt springen

Firebase Crashlytics für Capacitor-Apps

Erhalten Sie einen Schritt-für-Schritt-Leitfaden, um Crashlytics in Echtzeit in Ihre mobilen Apps zu integrieren, einschließlich der Einrichtung von Crashlytics für iOS- und Android-Apps.

Firebase Crashlytics für Capacitor-Apps

Firebase Crashlytics Hilft Ihnen, Anwendungsabbrüche in Echtzeit zu verfolgen und detaillierte Berichte bereitzustellen, um Probleme schnell zu beheben. Es integriert sich reibungslos mit Capacitor für beide iOS- und Android-Anwendungen. Hier ist, was Sie wissen müssen:

  • Warum Crashlytics verwenden?

    • Get Echtzeit-Fehlermeldungen.
    • Echtzeit-Alarme für Abstürze Analyse detaillierter Absturzberichte mit.
    • Automatischer Gruppierung von Problemen
  • Anforderungen für die Einrichtung:

    • Installieren Node.js (v16+), Capacitor (v4+), und Werkzeuge wie Xcode 14+ und Android Studio Elektrischer Aal.
    • 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).
  • Key Steps:

    • 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();
  • Testen Sie Ihre Konfiguration:

    • Auslösen Sie einen Testcrash:

      await FirebaseCrashlytics.crash();
  • Bonus-Tipp: Combine Crashlytics mit Capgo für sofortige Live-Updates ohne App-Store-Verzögerungen.

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

2021 Android-Anleitung: Firebase Crashlytics - benutzerdefinierte Fehlermeldungen …

Firebase Crashlytics

Setup-Anforderungen

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

Erforderliche Software und Konten

Sie benötigen die folgenden:

  • Node.js und (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 (für iOS erforderlich)

Plattformskonfigurationsdateien

Für iOS:

  • Laden Sie das GoogleService-Info.plist Datei vom Firebase-Konsolen herunter.
  • Aktualisieren Sie Podfile um Crashlytics-Abhängigkeiten zu beinhalten.
  • Fügen Sie die erforderlichen Datenschutzschlüssel in Ihre Info.plist Datei ein.

Für Android:

  • Erhalten Sie die google-services.json Datei aus der Firebase-Konsole.
  • Machen Sie Änderungen an beiden Projekt- und App-Ebene. build.gradle Dateien.
  • Aktualisieren Sie AndroidManifest.xml zur Einbindung der erforderlichen Berechtigungen.

Firebase Firebase-Konsole

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 Bundle-ID für iOS und das Paketname für Android.
    • Laden Sie die Konfigurationsdateien herunter: GoogleService-Info.plist für iOS und google-services.json für 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, sind Sie bereit, zur Plugin-Installation zu wechseln.

Installationsschritte

Plugin-Installation

Dann synchronisieren Sie das Plugin mit Ihren native Plattformen und sehen Sie sich die @capgo/capacitor-Firebase-Crashlytics Plugin-Seite für die vollständige API-Dokumentation an:

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

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

Android-Einrichtung

  1. Fügen Sie dem Crashlytics-Gradle-Plugin zu Ihrem App-Level- 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

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

  • Trigger a test crash with a custom key:

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

Wichtig: Beende Crash-Reports vor der App-Veröffentlichung. Um die Crash-Sammlung während der Entwicklung zu deaktivieren, verwende:

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

Anleitung 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.

Lesen von Crashberichten

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

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

Klicken Sie auf jede Problematik, um tiefer in Details wie Stapelüberwachung, 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 lösen, bevor sie zu vielen Benutzern Auswirkungen haben.

Tipps zur Fehlerverwaltung

  • Priorisierung nach AuswirkungKonzentrieren Sie sich auf Crashs, die am meisten Benutzer betreffen oder in kritischen Teilen Ihrer App auftreten. Durch das Verfolgen von Trends können Sie dringende Probleme identifizieren.

  • Verwendung von benutzerdefinierten Schlüsseln: Fügen Sie Kontext zu Ihren Crashberichten mit benutzerdefinierten Schlüsseln hinzu. Zum Beispiel:

    await FirebaseCrashlytics.setCustomKey({
      key: 'current_view',
      value: 'payment_processing'
    });
  • Gruppierung ähnlicher 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 und den Schutz der Benutzerdaten sicherzustellen, folgen Sie diesen Richtlinien:

  • Zugriffsrechte:

    • Melden Sie Crashberichterstattung in Ihrer Datenschutzrichtlinie.
    • Erheben Sie die Zustimmung der Benutzer für die Datenerfassung in Regionen mit GDPR-Regulierungen.
    • Bieten Sie Benutzern die Möglichkeit, sich von der Crashberichterstattung abzumelden.
  • Datenverarbeitungskontrollen:

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

    • Automatische Datenlöschung nach 90 Tagen einrichten.
    • Reinigen Sie sensible Informationen aus Ihren Berichten.
    • Use non-identifiable custom keys to maintain user privacy while debugging.

Capgo Integration

Capgo Live Update Dashboard-Interface

Vereinfachen Sie den Prozess von Crashdetektion bis Fix-Deploy durch das Pairing von Capgo’s live update-System mit Crashlytics.

Über Capgo

Capgo ist ein live update-Tool, das speziell für Capacitor-Anwendungen. With over 1,900 apps in production and a 95% update rate within 24 hours, it ensures quick fixes without the delays of app store approvals [1].

Hauptmerkmale umfassen:

  • Schlüsselmerkmale umfassen: End-to-End-Verschlüsselung
  • zur sicheren Aktualisierung Einfache Rückkehr
  • zu vorherigen Versionen Kanalbasierte Verteilung
  • zur gezielten Veröffentlichung und
  • A Eine offene-Quellensystemplattform

Crashlytics und Capgo

Verwendung von Crashlytics mit Capgo ermöglicht eine effiziente Arbeitsweise zur Identifizierung und Behebung 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-Stores bereitzustellen.

  2. Zielgerichtete Updates

    • Zielgerichtete UpdatesTesten Sie die Fixes mit einer bestimmten Gruppe, um sicherzustellen, dass sie wirksam sind.
    • Zielgerichtete Updates: Updates allmählich bereitstellen, um Risiken zu minimieren.
    • Notfall-Reparatur: Schnell pushen Sie kritische Patches, um dringende Probleme zu lösen.
  3. Überwachung und Verifizierung
    Nachdem Updates mit Capgo bereitgestellt wurden, verwenden Sie Crashlytics, um die Crashraten zu überwachen und bestätigen, dass das Problem behoben ist.

Sicherheit und Richtlinien des App-Stores

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 des App-Stores live update

Für eine sichere Integration mit Crashlytics:

  • Error-Tracking in beiden Systemen aktivieren.
  • Verwenden Sie die Überwachungstools von Capgo neben den Crashlytics-Berichten.
  • Mithalten von Versionen für alle Updates.
  • Halten Sie detaillierte Protokolle von Updates für Zwecke der Rechnungslegung.

Fortsetzen Sie zur Plugin-Optionen-Sektion, um andere live update Werkzeuge 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-Werkzeugen 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: 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 Release-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 Überblick über das, was Sie erreicht haben und was als Nächstes kommt:

Einstellungs-Schritte-Zusammenfassung

Sie haben drei wichtige Schritte abgeschlossen:

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

Pairung von Firebase Crashlytics mit Capgo bietet Ihnen ein leistungsstarkes System zur Fehlererkennung und aktualisierungsmanagementHier ist, was diese Combo bietet:

  • Rasche Reparaturen: Pushe sofortige Updates und rücke Änderungen mit nur einem Klick zurück.
  • Verlässliche Bereitstellungen: Stelle sicher, dass Updates weit verbreitet und glatt an die Benutzer geliefert werden.

Wat's Nächstes?

  1. Schalte detaillierte Fehleranalyse in der Firebase-Konsole ein.
  2. Füge Capgo zu deinem CI/CD-Pipeline hinzu, um Updates zu vereinfachen.
  3. Verwende Capgo-Kanäle Schritt für Schritt zu testen und Korrekturen freizugeben.

Mit Crashlytics und Capgo bist du bereit, um sicherzustellen, dass deine App reibungslos läuft und sich im Laufe der Zeit verbessert.

Fortsetzung von Firebase Crashlytics für Capacitor-Apps

Wenn Sie Firebase Crashlytics für __CAPGO_KEEP_0__-Apps verwenden Firebase Crashlytics für Capacitor-Apps 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 und Capgo-Native-Builds Für den 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 genehmigt ist. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Prozess bleiben.

Menschliche Unterstützung von Martin

Jetzt loslegen

Neueste von unserem Blog

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