La suite Firebase Local Emulator est un ensemble d'outils avancés pour les développeurs qui cherchent à créer et tester des applications localement à l'aide de Cloud Firestore, Realtime Database, Cloud Storage pour Firebase, Authentication, Firebase Hosting, Cloud Functions (bêta), Pub/Sub (bêta), et les extensions Firebase (bêta). Il fournit une interface utilisateur riche pour vous aider à démarrer et à prototyper rapidement.
Le développement local avec Local Emulator Suite peut être un bon choix pour vos workflows d'évaluation, de prototypage, de développement et d'intégration continue.
Avant que tu commences
Avant d'explorer Firebase Local Emulator Suite, nous vous recommandons de vous familiariser avec les produits Firebase et le modèle de développement Firebase :
- Lisez les rubriques Premiers pas avec Firebase pour votre plate-forme et vos produits ( Apple , Android ou Web ).
- Téléchargez une application de démarrage rapide prête à l'emploi sur la plate-forme de votre choix, puis lisez et exécutez le code. L'application de démarrage rapide FriendlyEats est un bon choix ( iOS , Android ou Web ).
Qu'est-ce que la suite d'émulateurs locaux Firebase ?
La suite d'émulateurs locaux Firebase se compose d'émulateurs de service individuels conçus pour imiter avec précision le comportement des services Firebase. Cela signifie que vous pouvez connecter votre application directement à ces émulateurs pour effectuer des tests d'intégration ou d'assurance qualité sans toucher aux données de production.
Par exemple, vous pouvez connecter votre application à l'émulateur Cloud Firestore pour lire et écrire en toute sécurité des documents lors des tests. Ces écritures peuvent déclencher des fonctions dans l'émulateur Cloud Functions. Cependant, votre application continuera à communiquer avec les services Firebase de production lorsque les émulateurs ne sont pas disponibles ou configurés.
Emulator Suite dans vos workflows locaux
Votre workflow de prototype et de test peut utiliser la suite d'émulateurs locaux de plusieurs manières :
- Tests unitaires : en utilisant le Firebase Test SDK, vous pouvez écrire des tests unitaires en Node.js en utilisant le test runner mocha. Le SDK de test fournit plusieurs méthodes pratiques pour charger les règles de sécurité, vider la base de données locale entre les tests et gérer l'interaction synchrone avec les émulateurs. C'est idéal pour écrire des tests simples pour les interactions de base de données qui ne dépendent pas de la logique de votre application.
- Tests d'intégration : chaque émulateur de produit individuel dans la suite d'émulateurs répond aux appels d'API SDK et REST, tout comme les services Firebase de production. Vous pouvez donc utiliser vos propres outils de test pour écrire des tests d'intégration autonomes qui utilisent Local Emulator Suite comme backend.
- Tests manuels : vous pouvez connecter votre application en cours d'exécution à la suite d'émulateurs locaux pour tester votre application Firebase manuellement, sans risquer les données de production ni configurer un projet de test.
- Évaluations de produits : vous pouvez installer et gérer les extensions Firebase dans un environnement local sécurisé et mieux comprendre leurs fonctionnalités tout en minimisant les coûts de facturation.
Quelles fonctionnalités et plates-formes Firebase sont compatibles ?
La suite d'émulateurs locaux Firebase vous permet de tester votre code avec nos produits de base de manière interopérable. L'émulateur Cloud Functions prend en charge les fonctions HTTP, les fonctions appelables et les fonctions d'arrière-plan déclenchées par Cloud Firestore, Realtime Database, Cloud Storage pour Firebase, Authentication et Pub/Sub. Les émulateurs Cloud Firestore, Realtime Database et Cloud Storage pour Firebase intègrent l'émulation des règles de sécurité Firebase.
| Nuage Firestore | Temps réel Base de données | Nuage Stockage pour Firebase | Authentification | Nuage Les fonctions | Nuage Pub/sous-marin | Rallonges | |
|---|---|---|---|---|---|---|---|
| SDK Android |  | | | | | n / A | n / A |
| SDK iOS | | | | | | n / A | n / A |
| Kit de développement Web | | | | | | n / A | n / A |
| SDK d'administration Node.js | | | | | n / A | | n / A |
Prochaines étapes
Démarrez avec une procédure pas à pas de Local Emulator Suite qui montre comment vous pouvez effectuer un prototypage hors ligne d'une base de données et de Cloud Functions.
Découvrez comment installer et configurer Local Emulator Suite .
Autres outils de prototypage et de test
La suite d'émulateurs est complétée par d'autres outils de prototype et de test.
Outils de test Cloud Functions. L'environnement Firebase CLI vous offre plusieurs façons de prototyper et de tester des fonctions :
- L'émulateur Cloud Functions, qui fait partie de la suite d'émulateurs. Cet émulateur est interopérable avec les données locales en direct et les règles de sécurité dans l'émulateur Firestore et/ou l'émulateur de base de données en temps réel.
- Le shell Cloud Functions, qui permet le prototypage et le développement de fonctions interactives et itératives. Le shell utilise l'émulateur Cloud Functions avec une interface de style REPL pour le développement. Aucune intégration avec les émulateurs Cloud Firestore ou Realtime Database n'est fournie. À l'aide du shell, vous simulez des données et effectuez des appels de fonction pour simuler l'interaction avec des produits que Local Emulator Suite ne prend pas actuellement en charge : Analytics, Remote Config et Crashlytics.
- Le SDK de test Firebase pour Cloud Functions, un Node.js avec un framework mocha pour le développement de fonctions. En effet, le SDK de test Cloud Functions fournit une automatisation au-dessus du shell Cloud Functions.
Vous trouverez plus d'informations sur le shell Cloud Functions et le SDK de test Cloud Functions sur Tester les fonctions de manière interactive et sur les tests unitaires de Cloud Functions .
Outils de test des règles de sécurité. Emulator Suite est l'ensemble d'outils préféré pour tester les règles de sécurité. Cependant, vous pouvez également utiliser :
- Le Rules Playground, une partie de la console Firebase. Le Rules Playground offre une excellente expérience interactive de démarrage avec la conception de règles de sécurité. Pour plus d'informations, consultez Valider rapidement les règles de sécurité Firebase .