Firebase Crashlytics für Capacitor-Apps

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

Warum Crashlytics verwenden?
- Erhalten Echtzeit-Fehlstartwarnungen.
- Analyse detaillierter Fehlstartberichte mit automatischer Problemerfassung.
- Überwachen kritischer Fehler, um Apps stabil zu halten.
Anforderungen für die Einrichtung:
- 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();

Ihre Konfiguration testen:
- Ein Testcrash auslösen:
```
await FirebaseCrashlytics.crash();
```
Tippschritt: Combine Crashlytics mit Capgo für sofortige Live-Updates ohne Verzögerung durch den App-Store.

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 Crash …

Firebase Crashlytics

Setupanforderungen

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

Erforderliche 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__
Aktualisieren Sie Ihren 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__
Machen Sie Änderungen an beiden Projekt- und Anwendungslevel- build.gradle __CAPGO_KEEP_0__
Aktualisieren Sie die AndroidManifest.xml __CAPGO_KEEP_0__

Firebase Firebase-Konsole-Einrichtung

Firebase-Plattform-Dashboard

Richten Sie Firebase ein und aktivieren Sie Crashlytics über diese Schritte:

Erstellen Sie ein Firebase-Projekt und aktivieren Sie Crashlytics.
Registrieren Sie Ihre Apps in der Firebase-Konsole:
- Verwenden Sie den __CAPGO_KEEP_1__ für iOS und das __CAPGO_KEEP_0__ für Android.
- Laden Sie die Konfigurationsdateien herunter: GoogleService-Info.plist (iOS) und google-services.json (Android).

Integrieren Sie die Firebase-SDKs in Ihre App, indem Sie diese Abhängigkeiten hinzufügen:

Für Android (app-level 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, zum Plugin-Installation-Bereich zu wechseln.

Installationsanweisungen

Plugin-Installation

Install das Plugin und synchronisiere es mit __CAPGO_KEEP_0__ Dann initialisiere Crashlytics in deiner App. Füge den folgenden Capacitor hinzu:

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

Then, initialize Crashlytics in your app. Add the following code to app.component.ts Plattform-Konfiguration main.ts:

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

Konfiguriere die erforderlichen Einstellungen für die Android- und iOS-Plattformen

Android-Konfiguration

Füge das Crashlytics-Gradle-Plugin zu deiner App-Level-

Datei: build.gradle Aktiviere die Crashsammlung in

buildscript { 
    dependencies { 
        classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
    } 
}
apply plugin: 'com.google.firebase.crashlytics'

iOS-Konfiguration AndroidManifest.xml:

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

oder

Firebase konfigurieren AppDelegate.swift:
```
import Firebase
FirebaseApp.configure()
```

Ihr Setup testen

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

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'});

Benutzerdefinierte Ereignisse protokollieren:

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: Entfernen Sie Crashaufrufe, bevor Sie Ihre App veröffentlichen. Um die Crashsammlung während der Entwicklung zu deaktivieren, verwenden Sie:

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

Überwachungshandbuch

Nachdem Sie Ihren Aufbau 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-Konsolenbereich unter Crashlytics.

Crash-freie Benutzer: Der Prozentsatz der Benutzer, die keine Crashs erlebt haben.
Stabilitätsprobleme: Wie oft treten Crashs 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, einzusteigen.

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

Tipps zur Fehlerverwaltung

Priorisierung nach Auswirkungen: Konzentrieren Sie sich auf Crashe, 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 mit benutzerdefinierten Schlüsseln Kontext zu Ihren Crashberichten 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 Crashe 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:

Zustimmung:
- Erwähnen Sie die Crashberichterstattung 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 Crashberichterstattung abzumelden.

Datenverarbeitungskontrollen:

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

Datenhaltung:
- Einstellen Sie die automatische Löschung von Daten nach 90 Tagen.
- Reinigen Sie sensible 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

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

Über Capgo

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

Hauptmerkmale umfassen:

End-to-End-Verschlüsselung für sichere Updates
Einfacher Rückfall auf vorherige Versionen Kanalbasierte Verteilung
für gezielte Releases Störungsfreie CI/CD-Integration
Ein
100% offener Quellcode-Plattform Crashlytics und __CAPGO_KEEP_0__ zusammen

Die Verwendung von Crashlytics mit Capgo ermöglicht eine effiziente Workflow für die Identifizierung und Behebung von Problemen.

Crashlytics und Capgo zusammen

Hier ist, wie es funktioniert:

Crash-Detektion und -Reaktion
Crashlytics erkennt einen Crash, und Capgo ermöglicht Ihnen, Fixes sofort bereitzustellen, ohne auf die Genehmigung des App-Stores zu warten.
Zielgerichtete Updates
- Beta-Testen: Testen Sie Fixes mit einer bestimmten Gruppe, um sicherzustellen, dass sie wirksam sind.
- Stufenweise Bereitstellung: Führen Sie Updates in kleinen Schritten aus, um Risiken zu minimieren.
- Notfall-Fix: Dringende Patches schnell bereitstellen, um dringende Probleme zu lösen.
Überwachung und Verifizierung
Nachdem Sie Updates mit Capgo bereitgestellt haben, verwenden Sie Crashlytics, um Crash-Raten zu überwachen und bestätigen, dass das Problem gelöst ist.

Sicherheit und App-Store-Richtlinien

Capgo erfüllt die Richtlinien von Apple und Google und bietet starke Sicherheitsfunktionen:

82% globale Erfolgsrate für die 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:

Aktivieren Sie die Fehleranalyse in beiden Systemen.
Verwenden Sie die Überwachungstools von Capgo neben den Berichten von Crashlytics.
Halten Sie die Versionskontrolle für alle Updates aufrecht.
Halten Sie detaillierte Protokolle von Updates für Prüfungszwecke auf.

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

Plugin-Optionen

Wählen Sie den richtigen Fehlerberichts-Plugin, um die Fehleridentifizierung und -behebung in Ihrer App erheblich zu beeinflussen.

Ein schneller Vergleich von Crashlytics mit anderen beliebten Fehlerberichts-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 für Teams, die bereits Firebase verwenden, attraktiv, 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 Ihnen ein mächtiges System für Fehler- 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: Stellen Sie sicher, dass Updates weit verbreitet und glatt an die Benutzer übermittelt werden.

Was kommt als Nächstes?

Detaillierte Crash-Analyse in der Firebase-Konsole aktivieren.
Fügen Sie Capgo Ihrem CI/CD-Pipeline hinzu, um Updates zu vereinfachen.
Verwenden Sie Capgo-Kanäle um Fixes Schritt für Schritt zu testen und freizugeben.

Mit Crashlytics und Capgo sind Sie bereit, Ihre App reibungslos und kontinuierlich zu verbessern.