Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Premiers pas avec le SDK Dart expérimental

La compatibilité expérimentale avec 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, suivez les tâches de configuration de 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 la CLI Firebase compatible avec Dart dans Cloud Functions for Firebase avec l'option --version :

 `firebase --version`

Activer le test dans la CLI Firebase

firebase experiments:enable dartfunctions

Initialisez votre projet

Exécutez la commande suivante :
```
firebase init functions
```
Sélectionnez Dart comme langage.
Lorsque vous êtes invité à installer les dépendances, 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 des options d'exécution.

Tester en local

firebase emulators:start

Une fois que Local Emulator Suite démarre, une ligne de journal 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étectera la modification et actualisera 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 sur les fonctions Dart.
Utilisez la version expérimentale de Dart Admin SDK pour interagir avec d'autres services Firebase, comme Cloud Firestore, depuis votre fonction.
En plus des fonctions HTTP onRequest, vous pouvez essayer un exemple onCall ou un exemple onCall avec streaming pour appeler des fonctions directement depuis votre application (en tenant compte de la limitation spéciale concernant la méthode d'appel).

Limites

Le déclencheur onCall peut être déployé, mais ne peut pas être appelé à partir des SDK clients 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 fonctions Cloud Run de la consoleCloud.

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