Firebase Crashlytics für Capacitor-Apps

Firebase Crashlytics Firebase Crashlytics hilft Ihnen, 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:

Warum Crashlytics verwenden?
- Erhalten Echtzeit-Alarme für Anwendungsfehler.
- Analyse detaillierter Fehlerberichte mit automatischer Problemerfassung.
- Ü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 Durchführung:

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 Tip: 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-Leitfaden: Firebase Crashlytics - benutzerdefinierte Crash …

Firebase Crashlytics

Setup-Anforderungen

Bevor Sie loslegen, 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)
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
The latest version of CocoaPods (erforderlich für iOS)

Plattform-Konfigurationsdateien

Für iOS:

Holen Sie sich das GoogleService-Info.plist Datei von der Firebase-Konsole.
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 App-Ebene build.gradle Dateien.
Aktualisieren Sie das AndroidManifest.xml um die erforderlichen Berechtigungen zu enthalten.

Firebase Konsolen-Setup

Firebase-Plattform-Dashboard

Konfigurieren Sie Firebase 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 das Bundle-ID für iOS und das Paketname für Android.
- Herunterladen Sie die Konfigurationsdateien: 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-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.

Installationsanweisungen

Plugin-Installation

Dann synchronisieren Sie das Plugin mit Ihren nativen Plattformen und sehen Sie sich die @capgo/capacitor-firebase-crashlytics Plugin-Seite für die vollständige API-Dokumentation:

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 die Android- und iOS-Plattformen ein.

Android-Einrichtung

Fügen Sie dem Gradle-Plugin für Crashlytics Ihre App-Ebene hinzu: build.gradle Datei:

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

Aktivieren Sie die Crashsammlung in AndroidManifest.xml:

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

iOS-Einrichtung

Konfigurieren Sie Firebase in AppDelegate.swift:
```
import Firebase
FirebaseApp.configure()
```

Testen Sie Ihre Einrichtung

Stellen Sie sicher, dass Crashlytics funktioniert, indem Sie einen Testcrash ausführen 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 Stapelüberwachung, Geräteinformationen und benutzerdefinierter Schlüssel, sollten innerhalb von etwa 5 Minuten in der Firebase-Konsole erscheinen.

Wichtiger Hinweis: Entfernen Sie die Crashaufrufe, bevor Sie Ihre App veröffentlichen. Um die Crashsammlung während der Entwicklung zu deaktivieren, verwenden Sie:

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

Überwachungsleitfaden

Nachdem Sie Ihre Einrichtung mit einem Testcrash bestätigt haben, verwenden Sie das Firebase-Konsolen, um tatsächliche Crashe und Fehler in Ihrer live App zu verfolgen.

Crashberichte lesen

Sie können Crashberichte im Firebase-Konsolen unter der Crashlytics-Sektion finden. 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 Meldung, um sich tiefer in Details wie Stacks, Geräteinformationen (z.B. Betriebssystemversion, Speicher), benutzerdefinierte Schlüssel, Protokolle und die Benutzerreise, die zum Absturz führte, einzusteigen.

Pro-TippEnable the “velocity alerts” feature to get notified when crash rates suddenly increase. This can help you address problems before they impact too many users.

Error Management Tips

Prioritise by Impact: Focus on crashes that affect the most users or occur in critical parts of your app. Tracking trends can help you identify urgent issues.

Use Custom Keys: Add context to your crash reports with custom keys. For example:

await FirebaseCrashlytics.setCustomKey({
  key: 'current_view',
  value: 'payment_processing'
});

Group Similar Issues: Take advantage of Firebase’s automatic issue grouping. You can also tag related crashes with consistent custom keys and use clear, descriptive titles for easier tracking.

Schutz der Benutzerdaten

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

Zugriffsrechte:
- Erwähnen Sie die Berichterstattung über Abstürze in Ihrer Datenschutzrichtlinie.
- Erlangen Sie die Zustimmung der Benutzer für die Datenerfassung in Regionen mit der GDPR-Regelung.
- Bieten Sie den Benutzern die Möglichkeit, sich von der Berichterstattung über Abstürze abzumelden.

Datenerfassungssteuerung:

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

Datenspeicherung:
- Konfigurieren 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 während der Debugging zu wahren.

Capgo Integration

Capgo Live Update Dashboard Interface

Das Prozess von Crash-Detektion bis zur Fix-Veröffentlichung vereinfachen, indem Sie Capgo’s Live-Update-System mit Crashlytics kombinieren.

Über Capgo

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

Hauptmerkmale umfassen:

End-to-End-Verschlüsselung für sichere Updates
Einzuklick-Abstieg zurück zu vorherigen Versionen
Kanalbasierte Verteilung für gezielte Releases
Einfache CI/CD-Integration
A 100% offene-Quellplattform

Crashlytics und Capgo zusammen

Die Verwendung von Crashlytics mit Capgo schafft einen effizienten Workflow zur schnellen Identifizierung und Lösung von Problemen.

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-Store-Verfahrens zu warten.
Zielgerichtete Updates
- Beta-Testen: Testen Sie Fixes mit einer bestimmten Gruppe, um sicherzustellen, dass sie wirksam sind.
- Stufenweiser Rollout: Gradually deploy Updates, um Risiken zu minimieren.
- Notfallkorrektur: Kritische Patches schnell bereitstellen, um dringende Probleme zu lösen.
Überwachung und Verifizierung
Nachdem Capgo Updates bereitgestellt wurden, verwenden Sie Crashlytics, um die Crash-Rate 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 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:

Fehlerüberwachung in beiden Systemen aktivieren.
Verwenden Sie Capgo’s Überwachungstools neben den Crashlytics-Berichten.
Halten Sie die Versionskontrolle für alle Updates aufrecht.
Halten Sie detaillierte Protokolle von Updates für Zwecke der Rechnungslegung auf.

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

Plugin-Optionen

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

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, die ab 26 €/Monat starten. 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.
RollbarAb 31 $/Monat. Funktioniert auf mehreren Plattformen, mit Funktionen wie der Abrechnungstracking und Personentracking.

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

Zusammenfassung

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

Zusammenfassung der Einrichtungsschritte

Sie haben drei wichtige Schritte zur Start abgeschlossen:

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

Weshalb diese Tools integrieren?

Die Kombination von Firebase Crashlytics mit Capgo gibt Ihnen ein leistungsstarkes System für Fehler- und Update-Management.. Hier ist, was diese Combo bietet:

Schnelllösungen: Drücken Sie Updates sofort 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 übermittelt werden.

Was kommt als Nächstes?

Aktivieren Sie detaillierte Crash-Analyse in der Firebase-Konsole.
Fügen Sie Capgo Ihrem CI/CD-Pipeline hinzu, um Updates auf einem Rutsch zu erhalten.
Verwenden Sie Capgo-Kanäle um Fixes Schritt für Schritt zu testen und freizugeben.

Mit Crashlytics und Capgo sind Sie bereit, um sicherzustellen, dass Ihre App reibungslos läuft und sich im Laufe der Zeit verbessert.

Weitermachen von Firebase Crashlytics für Capacitor Apps

Wenn Sie " Firebase Crashlytics für Capacitor Apps" verwenden 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 das Produktworkflow in Capgo Native Builds.