Inizia a utilizzare l'SDK Dart sperimentale

Il supporto sperimentale di Dart in Cloud Functions for Firebase ti consente di creare app full-stack con Flutter e Dart. Comunica con altri servizi Firebase con il nuovo SDK Admin Dart di Firebase.

Per iniziare a utilizzare le funzioni Dart, segui le attività di configurazione in questa guida e poi continua a esplorare le funzioni HTTP e richiamabili di Dart.

Prerequisiti

• SDK Dart 3.9 o versioni successive
• Interfaccia a riga di comando Firebase (versione 15.15.0 o successiva)

Verifica di avere una versione dell'interfaccia a riga di comando Firebase che supporta Dart in Cloud Functions for Firebase con il flag --version:

 `firebase --version`

Attiva l'esperimento nell'interfaccia a riga di comando Firebase

firebase experiments:enable dartfunctions

Inizializza il progetto

1. Esegui:

   firebase init functions
   

2. Seleziona Dart come linguaggio.

3. Quando ti viene chiesto "Vuoi installare le dipendenze ora?", rispondi "Sì".

Visualizza il codice della funzione

Visualizza il codice generato in functions/bin/server.dart (o nel tuo entry point). Questo codice mostra una semplice funzione HTTP.

Tieni presente che il codice campione imposta il numero massimo di istanze per la funzione helloWorld su 10 con il costruttore HttpsOptions. Puoi scoprire di più sulle opzioni di runtime in Imposta le opzioni di runtime.

Esegui test in locale

firebase emulators:start

Una volta avviata l'istanza Local Emulator Suite, vedrai una riga di log come functions http function initialized (http://127.0.0.1:5001/<url>). Carica l'URL nel browser per chiamare la funzione Dart emulata localmente.

Se modifichi il codice Dart, Firebase Local Emulator Suite rileverà la modifica e ricaricherà automaticamente la funzione.

Esegui il deployment

firebase deploy --only functions

Il processo di deployment per Dart è diverso da quello per le funzioni Node.js o Python. Anziché caricare il codice sorgente per la creazione in Cloud Build, l'interfaccia a riga di comando Firebase esegue un passaggio di compilazione Dart sulla macchina di sviluppo e carica il file binario generato direttamente nelle funzioni Cloud Run.

Al termine del deployment, vedrai una riga di log simile a Function URL (hello-world(us-central1)): https://hello-world-<random-hash>.<region>.run.app

Carica l'URL nel browser per chiamare la funzione Dart di cui hai appena eseguito il deployment.

Passaggi successivi

• Imposta le opzioni di configurazione, come il numero minimo di istanze.
• Scopri di più sulle funzioni HTTP e sulle funzioni richiamabili.
• Segui il codelab sulle funzioni Dart Codelab sulle funzioni Dart
• Utilizza Dart Admin SDK sperimentale per interagire con altri servizi Firebase, come Cloud Firestore, dalla tua funzione
• Oltre alle funzioni HTTP onRequest, puoi provare un esempio onCall o un esempio onCall con flussi di dati per chiamare le funzioni direttamente dalla tua app (tenendo presente la limitazione speciale relativa al metodo di chiamata).

Limitazioni

• Il trigger onCall può essere implementato, ma non può essere chiamato dagli SDK client con metodi come httpsCallable, che identificano le funzioni per nome. Puoi invece utilizzare metodi come httpsCallableFromURL e passare l'URL Cloud Run completo della tua funzione.
• Altri trigger, come quelli di Firestore, possono essere eseguiti nella suite di emulatori locali, ma non è possibile eseguirne il deployment.
• La console Firebase non visualizza le funzioni Dart durante la release sperimentale. Puoi visualizzare le funzioni Dart nella pagina delle funzioni Cloud Run della console Cloud.

Se riscontri problemi durante l'utilizzo delle funzioni Dart, ti invitiamo a inviare un report al team per aiutarci a migliorare ed espandere l'SDK Dart sperimentale.