Crashlytics Firebase pour les applications Capacitor

Firebase Crashlytics Aide à suivre les crashes d'applications en temps réel, 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.

Pourquoi utiliser Crashlytics ?
- Obtenez des alertes de crash en temps réel.
- Analysez les rapports de crash détaillés avec le regroupement 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 (Android). build.gradle (iOS) et (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 !

2021 Guide Android : 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 aurez besoin d'installer les éléments suivants :

Node.js (v16 ou supérieur) et Capacitor (v4 ou supérieur)
A 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 (obligatoire pour iOS)

Fichiers de configuration de plateforme

Pour iOS :

Téléchargez le GoogleService-Info.plist à partir du 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 Pour Android :

Obtenez le

à partir du Console Firebase. google-services.json Apportez des modifications aux fichiers à la fois au niveau du projet et au niveau de l'application.
file build.gradle file
Mettre à jour le AndroidManifest.xml pour y inclure les autorisations requises.

Firebase Configuration du Console

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 identifiant de l'application pour iOS et le 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 plugin page 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 d'application : build.gradle Activer la collecte de crashs dans

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

__CAPGO_KEEP_0__ AndroidManifest.xml:

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

Configuration iOS

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

Tester votre configuration

Confirmez que Crashlytics fonctionne en exécutant un test de crash et en vérifiant 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 apparaître 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.

Analyser les Rapports d'Erreurs

Vous pouvez trouver les rapports d'erreurs dans la Console Firebase dans la section Crashlytics. Voici ce que vous verrez :

Utilisateurs sans erreurs: Le pourcentage d'utilisateurs qui n'ont pas rencontré d'erreurs.
Stabilité des problèmes: La fréquence à laquelle les erreurs 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 menant à l'erreur.

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

Conseils de gestion des erreurs

Prioriser par Impact: Concentrez-vous sur les plantages qui affectent le plus d'utilisateurs ou se produisent dans des parties critiques de votre application. Suivre les tendances peut vous aider à identifier les problèmes urgents.
Utiliser des Clés personnalisées: Ajoutez du contexte à vos rapports de plantage avec des clés personnalisées. Par exemple :
```
await FirebaseCrashlytics.setCustomKey({
  key: 'current_view',
  value: 'payment_processing'
});
```
Groupement de Problèmes similaires: Profitez des groupements 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.

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 :

Permissions:
- : Menez une mention de la collecte de données dans votre politique de confidentialité.
- : Demandez l'accord 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 de la collecte de données.

Contrôle de la collecte de données:

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

Conservation des données:
- Configurez la suppression automatique des données après 90 jours.
- Supprimez les informations sensibles de vos rapports.
- Utilisez 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

Facilitez le processus de détection de crash à la mise à jour de correction 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 les Capacitor applications Avec 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 context : Page/zone : Site web de marketing Capgo. Rôle : Étiquette de navigation ou élément UI court. Clé de message `end_to_end_encryption` (Chiffrement de bout en bout).
pour des mises à jour sécurisées Annulation rapide
context : Page/zone : Site web de marketing Capgo. Rôle : Étiquette de navigation ou élément UI court. Clé de message `one_click_rollback` (Annulation rapide). vers les versions précédentes
Distribution basée sur les canaux
context : Page/zone : Site web de marketing Capgo. Rôle : Étiquette de navigation ou élément UI court. Clé de message `channel_based_distribution` (Distribution basée sur les canaux). pour des lancements ciblés

Intégration CI/CD sans heurts : A : 100 % de plateforme open-source : Crashlytics et Capgo Ensemble

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

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 bêtacontext : Page/zone : Page de marketing des solutions Capgo. Rôle : Étiquette de navigation ou élément de menu court. Vu dans : en-tête de site, page solutions/bêta-testing.astro. Clé de message `solutions_beta_testing` (Test de bêta des solutions).
- : Testez les correctifs avec un groupe spécifique pour vous assurer qu'ils sont efficaces.Rollout étalé
- : Déployez progressivement les mises à jour pour réduire les risques.Correctif d'urgence
: Faites passer rapidement des correctifs critiques pour résoudre les problèmes urgents.
After 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.

La sécurité et les 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 :

Un taux de réussite mondial de 82 % pour la livraison des mises à jour [1]
Contrôle de version automatique pour une meilleure organisation
Conformité aux lignes directrices de mise à jour en direct des magasins d'applications

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

Activez la suivi 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 à la section Options du Plugin pour explorer d'autres outils de mise à jour en direct.

Options du plugin

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

Here’s a quick comparison of Crashlytics with other popular error-reporting tools for Capacitor:

Sentry: Propose 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 des détails de contexte.
Bugsnag: Démarre à 47 €/mois. Couvre les deux plateformes mobile et web, avec des groupes d'erreurs automatiques et un suivi des versions.
Rollbar: S'élève à 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 :

Récapitulatif des étapes de configuration

Vous avez complété trois étapes clés pour démarrer :

Vous avez créé un projet Firebase et enregistré vos applications iOS/Android.
Vous avez installé et configuré le plugin Crashlytics.
Vous avez mis à jour les fichiers de plateforme iOS et Android nécessaires.

Pourquoi intégrer ces outils ?

Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and Mise à jour.

Résolution rapide : Mettez à jour instantanément et annulez les changements avec un seul clic.
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 vient ensuite ?

Activer les analyses détaillées des plantages dans la Console Firebase.
Ajoutez Capgo à votre pipeline CI/CD pour des mises à jour fluides.
Utilisez les canaux Capgo pour tester et lancer les 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 avec Firebase Crashlytics pour les applications Capacitor

Si vous utilisez Firebase Crashlytics pour les applications Capacitor pour planifier le travail de plugin natif, connectez-l’avec Répertoire de plugins Capgo pour le flux de travail du produit dans le Capgo Répertoire de plugins Capacitor Plugins par Capgo pour le détail d'implémentation dans les Capacitor Plugins par Capgo Ajouter ou Mettre à Jour les Plugins pour le détail d'implémentation dans Ajouter ou Mettre à Jour les Plugins Alternatives aux Plugins d'Entreprise Ionic pour le flux de travail du produit dans les Alternatives aux Plugins d'Entreprise Ionic, et Capgo Bâtiments Natives pour le flux de travail du produit dans les Capgo Bâtiments Natives.