La prise en charge expérimentale de Dart dans Cloud Functions for Firebase vous permet de créer des applications full stack avec Flutter et Dart. Communiquez avec d'autres services Firebase grâce au nouveau SDK Admin Dart Firebase.
Pour commencer à utiliser les fonctions Dart, effectuez les tâches de configuration décrites dans ce guide, puis continuez à explorer les fonctions HTTP et appelables Dart.
Prérequis
- Dart SDK 3.9 ou version ultérieure
- Firebase CLI (version 15.15.0 ou ultérieure)
Vérifiez que vous disposez d'une version de la CLI Firebase compatible avec Dart dans Cloud Functions for Firebase à l'aide de l'indicateur --version :
`firebase --version`
Activer le test dans la CLI Firebase
firebase experiments:enable dartfunctions
Initialisez votre projet
Exécutez la commande suivante :
firebase init functionsSélectionnez Dart comme langue.
Lorsque vous êtes invité à indiquer si vous souhaitez installer les dépendances maintenant, répondez "Oui".
Afficher le code de votre fonction
Affichez le code généré dans functions/bin/server.dart (ou votre point d'entrée). Ce code illustre une fonction HTTP simple.
Notez que l'exemple de code définit le nombre maximal d'instances pour la fonction helloWorld sur 10 avec le constructeur HttpsOptions. Pour en savoir plus sur les options d'exécution, consultez Définir les options d'exécution.
Tester en local
firebase emulators:start
Une fois que Local Emulator Suite a démarré, une ligne de journalisation semblable à functions http function initialized
(http://127.0.0.1:5001/<url>) s'affiche. Chargez cette URL dans votre navigateur pour appeler votre fonction Dart émulée localement.
Si vous modifiez votre code Dart, Firebase Local Emulator Suite détecte la modification et recharge automatiquement votre fonction.
Déployer
firebase deploy --only functions
Le processus de déploiement pour Dart est différent de celui des fonctions Node.js ou Python. Au lieu d'importer votre code source pour qu'il soit compilé dans Cloud Build, la CLI Firebase exécute une étape de compilation Dart sur votre ordinateur de développement et importe le binaire généré directement dans les fonctions Cloud Run.
Une fois le déploiement terminé, une ligne de journal semblable à Function URL
(hello-world(us-central1)): https://hello-world-<random-hash>.<region>.run.app s'affiche.
Chargez cette URL dans votre navigateur pour appeler votre fonction Dart nouvellement déployée.
Étapes suivantes
- Définissez des options de configuration, comme le nombre minimal d'instances.
- En savoir plus sur les fonctions HTTP et les fonctions appelables
- Suivez l'atelier de programmation Dart Functions Atelier de programmation Dart Functions
- Utilisez le Admin SDK Dart expérimental pour interagir avec d'autres services Firebase, comme Cloud Firestore, à partir de votre fonction.
- En plus des fonctions HTTP
onRequest, vous pouvez essayer un exempleonCallou un exempleonCallavec streaming pour appeler des fonctions directement depuis votre application (en notant la limitation spéciale concernant la méthode d'appel).
Limites
- Le déclencheur
onCallpeut être déployé, mais ne peut pas être appelé à partir des SDK client avec des méthodes telles que httpsCallable, qui identifient les fonctions par leur nom. Vous pouvez utiliser des méthodes telles que httpsCallableFromURL et transmettre l'URL Cloud Run complète de votre fonction. - D'autres déclencheurs, tels que les déclencheurs Firestore, peuvent être exécutés dans la suite d'émulateurs locaux, mais ne peuvent pas être déployés.
- La console Firebase n'affiche pas les fonctions Dart lors de la version expérimentale. Vous pouvez afficher les fonctions Dart sur la page Cloud Run des fonctions de la consoleCloud.
Si vous rencontrez des problèmes lorsque vous travaillez avec des fonctions Dart, nous vous encourageons à envoyer un rapport à l'équipe pour nous aider à améliorer et à étendre le SDK Dart expérimental.