Présentation de la suite d'émulateurs locaux Firebase

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, Authentication, Cloud Functions, Pub/Sub et Firebase Hosting. 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 de prototypage, de développement et d'intégration continue.

Ajout de Firebase Local Emulator Suite à vos workflows de développement.

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 :

  • Lire le Get a commencé avec des sujets Firebase pour votre plate - forme et des produits ( iOS , 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 FriendlyEats est un bon choix ( iOS , Android ou Web ).

Qu'est-ce que la suite d'émulateurs locaux Firebase ?

Firebase Local Emulator Suite se compose d'émulateurs de services 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 un contrôle qualité sans toucher aux données de production.

Par exemple, vous pouvez connecter votre application à l'émulateur Cloud Firestore pour lire et écrire des documents en toute sécurité 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 prototype et votre workflow de test peuvent utiliser la suite d'émulateurs locaux de trois manières :

  • Tests unitaires: en utilisant le SDK Firebase test, vous pouvez écrire des tests unitaires dans Node.js en utilisant le lanceur de test mocha. Le Kit de développement logiciel (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 chaque produit dans l'émulateur Suite répond à SDK et API REST appels tout comme les services de production Firebase. Vous pouvez donc utiliser vos propres outils de test pour écrire des tests d'intégration autonomes qui utilisent la suite d'émulateurs locaux comme backend.
  • Tests manuels: vous pouvez connecter votre application en cours d' exécution à l'émulateur local Suite pour tester votre application Firebase manuellement, sans risquer des données de production ou de la configuration d' un projet de test.

Quelles fonctionnalités et plates-formes Firebase sont prises en charge ?

La Firebase Local Emulator Suite 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, Authentication et Pub/Sub ; l'émulateur Cloud Functions n'est pas compatible avec les fonctions d'arrière-plan déclenchées par Cloud Storage pour Firebase. Pour les émulateurs Cloud Firestore et Realtime Database, l'émulation des règles de sécurité est intégrée.

Nuage
Firestore
Temps réel
Base de données
Nuage
Stockage
Authentification Nuage
Les fonctions
Nuage
Pub/Sub
SDK Android n / A
SDK iOS n / A
SDK Web n / A
SDK d'administration Node.js n / A

Prochaines étapes

Autres outils de prototypage et de test

La suite d'émulateurs est complétée par d'autres prototypes et outils de test.

Outils de test de Cloud Functions. L'environnement de la CLI Firebase 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 en direct et les règles de sécurité locales 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 une interaction avec des produits que la suite d'émulateurs locaux ne prend pas actuellement en charge : Cloud Storage, Pub/Sub, Analytics, Remote Config, Storage, Auth et Crashlytics.
  • Le SDK Firebase Test pour Cloud Functions, un framework Node.js avec 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 pouvez trouver plus sur les fonctions de Cloud shell et les fonctions de Cloud SDK de test à des fonctions de test de manière interactive et tests unitaires des fonctions de Cloud .

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 :

  • The Rules Playground, une partie de la console Firebase. Le terrain de jeu des règles offre une excellente expérience de démarrage interactive avec la conception des règles de sécurité. Pour plus d' informations , consultez rapidement les règles de sécurité validate Firebase .