Passer au contenu principal

Crashlytics Firebase pour les applications Capacitor

Apprenez à intégrer un rapport de crash en temps réel dans vos applications mobiles avec une guide étape par étape sur la mise en place de Crashlytics pour les deux iOS et Android.

Crashlytics Firebase pour les applications Capacitor

Firebase Crashlytics Aidez-vous à suivre les plantages 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. Voici ce que vous devez savoir :

  • Pourquoi Utiliser Crashlytics ?

    • Obtenez des alertes de plantage en temps réel.
    • Analysez des rapports de plantage 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).
    • Mettez à jour les fichiers spécifiques à la plateforme comme Podfile (iOS) et build.gradle (Android).
  • Étapes Clés :

    • Installez Crashlytics :

      npm install @capgo/capacitor-firebase-crashlytics && npx cap sync
    • Initialisez Crashlytics dans votre application :

      import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
      await FirebaseCrashlytics.initialize();
  • Testez votre configuration :

    • Déclenchez 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 : Firebase Crashlytics - crashs personnalisés …

Firebase Crashlytics

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 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 (obligatoire pour iOS)

Fichiers de configuration de plateforme

Pour iOS :

  • Téléchargez le GoogleService-Info.plist fichier depuis le Console Firebase.
  • Mettez à 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 depuis le Console Firebase.
  • Apportez des modifications aux deux niveaux, projet et application. build.gradle Fermez les fichiers.
  • Mettez à jour le AndroidManifest.xml pour y inclure les autorisations requises.

Firebase Configuration du Console Firebase

Tableau de bord de la plateforme Firebase

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

  1. Créez un projet Firebase et activez Crashlytics.

  2. Inscrivez vos applications dans la Console Firebase :

    • Utilisez l'ID de l'application pour iOS et le nom de package pour Android. Téléchargez les fichiers de configuration : (iOS) et
    • (Android). GoogleService-Info.plist Intégrez les SDK Firebase google-services.json dans votre application en ajoutant ces dépendances :
  3. Pour Android (niveau d'application Pour iOS (

    __CAPGO_KEEP_0__ 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'
    }

    __CAPGO_KEEP_1__Podfile):

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

Une fois ces étapes terminées, vous êtes prêt à passer à la section d'installation des plugins.

Étapes d'installation

Installation des plugins

Ensuite, synchronisez le plugin avec vos plateformes natives et consultez la @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

Ensuite, initialisez Crashlytics dans votre application. Ajoutez les suivants code à app.component.ts ou main.ts:

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

Contexte : Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `alternatives_cta_questions`). Page/zone : Comparaison de alternatives de mise à jour en direct de Capacitor. Rôle : Paragraphe de marketing ou juridique long. Voir dans : page alternatives.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `alternatives_cta_questions` (Questions de CTA alternatives). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `appflow_cta_questions`). Page/zone : Comparaison et migration de marketing de Appflow. Rôle : Paragraphe de marketing ou juridique long. Voir dans : page ionic-appflow.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `appflow_cta_questions` (Questions de CTA Appflow). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `capwesome_cta_questions`). Page/zone : Page de comparaison de Capawesome. Rôle : Paragraphe de marketing ou juridique long. Voir dans : page capwesome.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `capwesome_cta_questions` (Questions de CTA Capawesome). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `consulting_faq_subtitle`). Page/zone : Page de services de conseil. Rôle : Sous-titre ou tagline de section. Voir dans : page consulting.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `consulting_faq_subtitle` (Sous-titre FAQ de conseil). | Page/zone : Comparaison et migration de marketing de Appflow. Rôle : Étiquette de navigation ou élément de navigation court. Voir dans : page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Clé de message `appflow_plugins_or` (Appflow Plugins ou).

Configuration de la plateforme

Configurez les configurations requises pour les plateformes Android et iOS.

  1. Configuration Android de Crashlytics : Ajoutez le plugin Gradle Crashlytics à votre niveau d'application : build.gradle file:

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. Activer la collecte de crash dans AndroidManifest.xml:

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

iOS Configuration

  1. Configurer Firebase dans AppDelegate.swift:

    import Firebase
    FirebaseApp.configure()

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

Lecture des rapports de crash

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

  • Utilisateurs sans crash: Le pourcentage d'utilisateurs qui n'ont pas eu de crash.
  • Stabilité des problèmes: La fréquence à laquelle les crashs 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 au crash.

Conseil pro: Activer la fonctionnalité « alertes de vitesse » pour être averti 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

  • Prioriser par Impact: Concentrez-vous sur les crashes 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 crash 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 crashes 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 normes et protéger les données des utilisateurs, suivez ces lignes directrices :

  • Permissions:

    • : Mentionnez la gestion des rapports de crash dans votre politique de confidentialité.
    • Obtenez le consentement des utilisateurs pour la collecte de données dans les régions régies par les réglementations GDPR.
    • Proposez aux utilisateurs l'option de se désister de la rapportage des crashes.
  • Contrôles de 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 tout en déboguant.

Capgo Intégration

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

Facilitez le processus de détection des crashes à la mise en production de correction en associant le système de mise à jour en direct de Capgo à Crashlytics.

À propos de Capgo

Capgo est un outil d'actualisation en temps réel conçu spécifiquement pour 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 fonctionnalités clés incluent :

  • Chiffrement de bout en bout context : Page/zone : Site web de marketing Capgo. Rôle : Étiquette de navigation ou élément de menu 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 de menu court. Message clé `one_click_rollback` (Annulation rapide). vers les versions précédentes
  • Distribution basée sur le canal
  • context : Page/zone : Site web de marketing Capgo. Rôle : Étiquette de navigation ou élément de menu court. Message clé `channel_based_distribution` (Distribution basée sur le canal). plateforme 100% open-source

Crashlytics and Capgo Together

Using Crashlytics with Capgo creates an efficient workflow for identifying and resolving issues quickly.

Ici’s comment ça marche :

  1. Détection et réponse aux crashs
    Crashlytics identifies a crash, and Capgo allows you to deploy fixes instantly without waiting for app store approval.

  2. Mises à jour ciblées

    • Test de bêtacontext : Page/zone : Page de marketing des solutions Capgo. Rôle : Étiquette de navigation courte ou élément UI. Vue dans : en-tête de site, page solutions/bêta-testing.astro. Clé de message `solutions_beta_testing` (Test de bêta des solutions).
    • : Tester les correctifs avec un groupe spécifique pour vous assurer qu'ils sont efficaces.Rollout étape par étape
    • : Déployer progressivement les mises à jour pour réduire les risques. : Envoyez rapidement des correctifs critiques pour résoudre les problèmes urgents.
  3. Surveillance et Vérification
    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 des 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 surveillance des erreurs dans les deux systèmes.
  • Utilisez les outils de surveillance de Capgo en parallèle des rapports de Crashlytics.
  • Maintenez le contrôle de version pour toutes les mises à jour.
  • Conservation de 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 temps réel.

Options du Plugin

Le choix du bon plugin de signalement de plantages 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: 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 un contexte détaillé.
  • Bugsnag: Démarre à 47 €/mois. Couvre les plateformes mobiles 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 ?

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 à jourVoici ce que ce combo offre :

  • Réparations rapides: Mettre à jour instantanément et annuler les modifications avec juste un clic.
  • Rollouts fiables: Assurer que les mises à jour sont largement adoptées et livrées de manière fluide aux utilisateurs.

Qu'est-ce qui vient ensuite ?

  1. Activer les analyses de crash détaillées dans le Console Firebase.
  2. Ajouter Capgo à votre pipeline CI/CD pour des mises à jour fluides.
  3. Utiliser 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, le connecter avec Capgo Répertoire de plugin pour le flux de travail du produit dans Capgo Répertoire de plugin, Capacitor Plugins par Capgo pour le détail d'implémentation dans Capacitor Plugins par Capgo Ajout ou mise à jour de plugins pour le détail d'implémentation dans Ajout ou mise à jour de plugins, Alternatives de plugins d'entreprise Ionic pour le flux de travail du produit dans Alternatives de plugins d'entreprise Ionic, et Capgo Bâtiments natifs pour le flux de travail du produit dans Capgo Bâtiments natifs.

Mises à jour en temps réel pour les applications Capacitor

Quand un bug de la couche web est en ligne, expédiez la correction par Capgo au lieu d'attendre des jours pour l'approbation de la boutique d'applications. Les utilisateurs reçoivent la mise à jour en arrière-plan tandis que les modifications natives restent dans la voie de revue normale.

Support humain de Martin

Démarrer Maintenant

Dernières actualités de notre Blog

Capgo vous donne les meilleures informations dont vous avez besoin pour créer une application mobile vraiment professionnelle.