Premiers pas avec le SDK Dart expérimental

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 à l'aide du nouveau Firebase SDK Admin pour Dart.

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

SDK Dart 3.9 ou version ultérieure
Firebase CLI (version 15.15.0 ou ultérieure)

Vérifiez que vous disposez d'une version de Firebase CLI compatible avec Dart dans Cloud Functions for Firebase à l'aide de l'option --version :

 `firebase --version`

Activer le test dans Firebase CLI

firebase experiments:enable dartfunctions

Initialiser votre projet

Exécutez la commande bash firebase init functions.
Sélectionnez Dart comme langage.
Lorsque vous êtes invité à installer les dépendances, répondez "Yes" (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 le Local Emulator Suite est 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, le 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, leFirebase CLI exécute une étape de compilation Dart sur votre machine de développement et importe directement le binaire généré dans les fonctions Cloud Run.

Une fois le déploiement terminé, une ligne de journalisation 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 telles que le nombre minimal d'instances.
En savoir plus sur les fonctions HTTP et les fonctions appelables.
Suivez l'atelier de programmation Fonctions Dart Fonctions Dart.
Utilisez le Dart Admin SDK expérimental pour interagir avec d'autres services Firebase, tels que Cloud Firestore, à partir de votre fonction.
En plus des onRequest fonctions HTTP, vous pouvez essayer un onCall exemple ou onCall avec streaming exemple pour appeler des fonctions directement depuis votre application (en tenant compte de la limite spéciale concernant la méthode d'appel).

Limites

Le onCall déclencheur peut être déployé, mais ne peut pas être appelé à partir de 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 pendant la version expérimentale. Vous pouvez afficher les fonctions Dart sur la page des Cloud Run fonctions de la Cloud console à la place.

Si vous rencontrez des problèmes lorsque vous utilisez des fonctions Dart, nous vous encourageons à envoyer un rapport à l'équipe pour nous aider à améliorer et à étendre le SDK Dart expérimental.