Crashlytics Firebase pour les applications Capacitor

Firebase Crashlytics l'aide à suivre les plantages d'applications en temps réel, en fournissant des rapports détaillés pour résoudre les problèmes rapidement. Il s'intègre de manière fluide avec Capacitor pour les applications iOS et Android. Voici ce qu'il faut savoir :

Pourquoi Utiliser Crashlytics ?
- Obtenez des alertes de crash en temps réel.
- Analysez des rapports de crash détaillés avec groupage automatique des problèmes.
- Surveillez les erreurs critiques pour maintenir les applications stables.
Exigences de configuration :
- Installez Node.js (v16+), Capacitor (v4+), et outils comme Xcode 14+ et Android Studio Electric Eel.
- Télécharger Firebase les fichiers de configuration (GoogleService-Info.plist pour iOS, google-services.json pour Android).
- Mettre à jour les fichiers spécifiques à la plateforme comme Podfile (iOS) et build.gradle (Android).

Étapes Clés :

Installer Crashlytics :

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

Initialiser Crashlytics dans votre application :

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

Tester votre Configuration :
- Déclencher un crash de test :
```
await FirebaseCrashlytics.crash();
```
Conseil Bonus : Combinez Crashlytics avec Capgo pour des mises à jour en direct instantanées sans retard de l'App Store.

Cette guide vous garantit que votre application est exempte de plantages et conviviale. Commencez par configurer Firebase Crashlytics dès aujourd'hui !

Guide Android 2021 : Crashlytics Firebase - crash … personnalisé …

Crashlytics Firebase

Exigences de configuration

Avant de plonger, assurez-vous d'avoir terminé les étapes suivantes :

Logiciels et comptes requis

Vous devrez installer les éléments suivants :

Node.js (v16 ou supérieur) et Capacitor ou une version supérieure (v4 ou supérieure)
A un compte Firebase avec un projet actif
Xcode 14+ pour le développement iOS
Android Studio Electric Eel ou une version plus récente pour le développement Android
La dernière version de CocoaPods requise pour iOS

Fichiers de configuration de plateforme

Pour iOS :

Téléchargez le GoogleService-Info.plist Le fichier à partir de la Console Firebase.
Met à jour votre Podfile pour y inclure les dépendances de Crashlytics.
Ajoutez les clés de confidentialité nécessaires à votre Info.plist fichier.

Pour Android :

Obtenez le google-services.json fichier à partir de la Console Firebase.
Apportez des modifications aux fichiers de niveau de projet et d'application. build.gradle file
Mettre à jour AndroidManifest.xml pour y inclure les permissions requises.

Firebase Configuration de l'interface de ligne de commande

Tableau de bord de la plateforme Firebase

Configurez Firebase et activez Crashlytics à l'aide de ces étapes :

Créez un projet Firebase et activez Crashlytics.
Enregistrez vos applications dans la console Firebase :
- Utilisez le ID de l'application pour iOS et le nom du package pour Android.
- Téléchargez les fichiers de configuration : GoogleService-Info.plist (iOS) et google-services.json (Android).

Intégrez les SDK Firebase dans votre application en ajoutant ces dépendances :

Pour Android (niveau d'application 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'
}

Pour iOS (Podfile):

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

Une fois ces étapes terminées, vous êtes prêt à passer à la section Installation du Plugin.

Étapes d'installation

Installation du plugin

Ensuite, synchronisez le plugin avec vos plateformes natives et voyez le @capgo/capacitor-firebase-crashlytics page du plugin pour la référence complète de API :

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

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

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

Configuration de la plateforme

Configurez les configurations requises pour les plateformes Android et iOS.

Configuration Android

Ajoutez le plugin Gradle Crashlytics à votre fichier de niveau d'application build.gradle fichier :

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

Activez la collecte des crashs dans AndroidManifest.xml:

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

Configuration iOS

Configurez Firebase dans AppDelegate.swift:
```
import Firebase
FirebaseApp.configure()
```

Testez votre configuration

Vérifiez que Crashlytics fonctionne en exécutant un test de crash et en consultant le Console Firebase :

Déclenchez un test de crash avec une clé personnalisée :

await FirebaseCrashlytics.setCustomKey({key: 'test_scenario', value: 'manual_crash'});
await FirebaseCrashlytics.crash();

Optionnellement, identifiez un utilisateur :

await FirebaseCrashlytics.setUserId({userId: 'user123'});

Enregistrez des événements personnalisés :

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

Les rapports, y compris les traces de pile, les détails du dispositif et les clés personnalisées, devraient apparaitre dans le Console Firebase dans environ 5 minutes.

Important : Supprimez les appels de crash avant de publier votre application. Pour désactiver la collecte de crash pendant le développement, utilisez :

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

Guide de suivi

Une fois que vous avez confirmé votre configuration avec un test de crash, utilisez le Console Firebase pour suivre les vrais crashs et les erreurs dans votre application en direct.

Lecture des Rapports de Crashes

Vous pouvez trouver les rapports de crash dans la Console Firebase dans la section Crashlytics. Voici ce que vous verrez :

Utilisateurs sans crash: Le pourcentage d'utilisateurs qui n'ont pas rencontré de crash.
Stabilité des problèmes: La fréquence à laquelle les crashes se produisent.
Analyse de l'impact: Le nombre d'utilisateurs affectés.

Cliquez sur n'importe quel problème pour plonger plus profondément dans les détails comme les traces de pile, les informations sur le dispositif (par exemple, la version du système d'exploitation, la mémoire), les clés personnalisées, les journaux et le parcours de l'utilisateur qui a conduit à la crash.

Conseil pro: Activez la fonctionnalité « alertes de vitesse » pour vous faire notifier lorsque les taux de crash augmentent soudainement. Cela peut vous aider à résoudre les problèmes avant qu'ils n'affectent trop d'utilisateurs.

Conseils de gestion des erreurs

Prioritisez par Impact: Concentrez-vous sur les plantages qui affectent le plus d'utilisateurs ou se produisent dans des parties critiques de votre application. La traçabilité des tendances peut vous aider à identifier les problèmes urgents.
Utilisez des Clés personnalisées: Ajoutez du contexte aux rapports de plantage avec des clés personnalisées. Par exemple :
```
await FirebaseCrashlytics.setCustomKey({
  key: 'current_view',
  value: 'payment_processing'
});
```
Grouppez les Problèmes similaires: Profitez des groupages automatiques de problèmes proposés par Firebase. Vous pouvez également étiqueter les plantages liés avec des clés personnalisées cohérentes et utiliser des titres clairs et descriptifs pour une traçabilité plus facile.

La Protection de la Vie Privée des Utilisateurs

Pour garantir le respect des réglementations et protéger les données des utilisateurs, suivez ces lignes directrices :

Les Autorisations:
- Mentionnez le rapport de plantage dans votre politique de confidentialité.
- Obtenez le consentement des utilisateurs pour la collecte de données dans les régions soumises à la réglementation GDPR.
- Fournissez aux utilisateurs l'option de se désinscrire du rapport de plantage.

Contrôle de collecte de données:

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

Conservation de données:
- Configurer la suppression automatique des données après 90 jours.
- Effacer les informations sensibles de vos rapports.
- Utiliser des clés personnalisées non identifiables pour maintenir la vie privée des utilisateurs pendant la débogage.

Capgo Intégration

Capgo Interface de tableau de bord de mise à jour en direct

Faciliter le processus de détection de plantage à la mise à jour de déploiement en associant le système de mise à jour en direct de Capgo à Crashlytics.

À propos de Capgo

Capgo est un outil de mise à jour en direct conçu spécifiquement pour Capacitor applicationsAvec plus de 1 900 applications en production et un taux d'actualisation de 95% en 24 heures, il garantit des corrections rapides sans les retards des approbations des magasins d'applications. [1].

Les principales fonctionnalités comprennent :

Chiffrement de bout en bout pour des mises à jour sécurisées
Annulation rapide vers des versions précédentes
Distribution basée sur les canaux pour des lancements ciblés
Intégration CI/CD sans heurt
Une plateforme 100% open-source Crashlytics et __CAPGO_KEEP_0__ Ensemble

Crashlytics and Capgo Together

En utilisant Crashlytics avec Capgo crée un flux de travail efficace pour identifier et résoudre les problèmes rapidement.

Voici comment cela fonctionne :

Détection et Réponse aux Crashes
Crashlytics identifie un crash, et Capgo vous permet de déployer des correctifs instantanément sans attendre l'approbation de la boutique d'applications.
Mises à jour ciblées
- Test de fixes avec un groupe spécifique pour s'assurer qu'elles sont efficaces.Déploiement étalé
- Déployer progressivement les mises à jour pour réduire les risques.Réparation d'urgence
- Pousser rapidement des correctifs critiques pour résoudre les problèmes urgents.Surveillance et Vérification
Test de fixes avec un groupe spécifique pour s'assurer qu'elles sont efficaces.
Après avoir déployé des mises à jour avec Capgo, utilisez Crashlytics pour suivre les taux de crash et confirmer que le problème est résolu.

Sécurité et Règles de l'App Store

Capgo respecte les politiques d'Apple et de Google tout en fournissant des fonctionnalités de sécurité solides :

Taux de réussite mondial de 82 % pour la livraison de mises à jour [1]
Contrôle de version automatique pour une meilleure organisation
Conformité aux lignes directrices de mise à jour en direct de l'App Store

Pour une intégration sécurisée avec Crashlytics :

Activer la traçabilité des erreurs dans les deux systèmes.
Utilisez les outils de suivi de Capgo en parallèle des rapports de Crashlytics.
Maintenez un contrôle de version pour toutes les mises à jour.
Conservez des journaux détaillés des mises à jour à des fins de vérification.

Continuez vers la section Options du Plugin pour explorer d'autres outils de mise à jour en direct.

Options du plugin

Le choix du bon plugin de signalement de crash peut avoir un impact considérable sur la façon dont vous identifiez et réparez les erreurs dans votre application.

Voici une comparaison rapide de Crashlytics avec d'autres outils populaires de signalement d'erreurs pour Capacitor:

Sentry: Offre un niveau gratuit avec des plans payants à partir de 26 €/mois. Supporte plus de 30 plateformes et fournit un suivi en temps réel des erreurs avec un contexte détaillé.
Bugsnag: Démarre à 47 €/mois. Couvre les deux plateformes mobile et web, avec des groupes d'erreurs automatiques et un suivi des versions.
Rollbar: Évalué à partir de 31 €/mois. Fonctionne sur plusieurs plateformes, avec des fonctionnalités comme le suivi des déploiements et le suivi des personnes.

Crashlytics est particulièrement attractif pour les équipes qui utilisent déjà Firebase, grâce à son intégration fluide et à un niveau gratuit.

Résumé

Voici un aperçu rapide de ce que vous avez accompli et de ce qui vient ensuite :

Étapes de configuration Récapitulatif

Vous avez complété trois étapes clés pour vous lancer :

Créer un projet Firebase et enregistrer vos applications iOS/Android.
Installer et configurer le plugin Crashlytics.
Mettre à jour les fichiers de plateforme iOS et Android nécessaires.

Pourquoi Intégrer Ces Outils ?

L'association de Crashlytics Firebase avec Capgo vous offre un système puissant pour le suivi des erreurs et la gestion des mises à jour. Mise à jour de l'applicationRésolution rapide :

Déployer des mises à jour instantanées et annuler les changements avec un seul clic.Déploiements fiables :
Déploiements fiables :: Assurez-vous que les mises à jour soient largement adoptées et livrées de manière fluide aux utilisateurs.

Qu'est-ce qui suit ?

Activer les analyses de crash détaillées dans le Console Firebase.
Ajoutez Capgo à votre pipeline CI/CD pour des mises à jour fluides.
Utilisez Capgo canaux pour tester et lancer des correctifs étape par étape.

Avec Crashlytics et Capgo en place, vous êtes prêt à garder votre application en cours de fonctionnement et à l'améliorer au fil du temps.

Continuez à partir de Firebase Crashlytics pour les applications Capacitor

Si vous utilisez Firebase Crashlytics pour les applications Capacitor pour planifier le travail de plugin natif, connectez-le Répertoire des plugins Capgo pour le flux de travail du produit dans le répertoire des plugins Capgo Capacitor Plugins par Capgo pour le détail d'implémentation dans les plugins Capacitor par Capgo, Ajout ou mise à jour des plugins pour le détail d'implémentation dans Ajout ou mise à jour des plugins, Alternatives de plugins Ionic Enterprise pour le flux de travail du produit dans les alternatives de plugins Ionic Enterprise, et Capgo Builds natifs pour le flux de travail du produit dans les builds natifs Capgo.