Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Inizia a utilizzare Firebase nel tuo progetto Flutter

Prerequisiti

Installa l'editor o l'IDE che preferisci.
Installa Flutter per il tuo sistema operativo specifico, tra cui:
- SDK Flutter
- Librerie di supporto
- Software e SDK specifici della piattaforma

Prerequisiti specifici della piattaforma:

Apple

Configura un dispositivo Apple fisico o utilizza un simulatore per eseguire l'app.
Assicurati che la tua app Flutter abbia come target le seguenti versioni della piattaforma o versioni successive:
- iOS 15
- macOS 10.15

Vuoi utilizzare Cloud Messaging?

Per Cloud Messaging sulle piattaforme Apple, ecco i prerequisiti:

Configura un dispositivo Apple fisico.

Ottieni una chiave di autenticazione delle notifiche push di Apple per il tuo account sviluppatore Apple.

Attiva le notifiche push in Xcode in App > Capabilities.

Android

Configura un dispositivo o un emulatore per eseguire la tua app. Gli emulatori devono utilizzare un'immagine dell'emulatore con Google Play.
Assicurati che la tua app soddisfi i seguenti requisiti:
- Target del livello API 23 (Marshmallow) o versioni successive
- Utilizza Android 6.0 o versioni successive

Web

Nessun prerequisito specifico della piattaforma

Se non hai ancora un'app Flutter, puoi completare la Guida introduttiva: prova per creare una nuova app Flutter utilizzando l'editor o l'IDE che preferisci.

Passaggio 1: installa gli strumenti della riga di comando richiesti

Se non l'hai ancora fatto, installa la CLI Firebase.
Accedi a Firebase utilizzando il tuo Account Google eseguendo questo comando:
```
firebase login
```
Installa l'interfaccia a riga di comando FlutterFire eseguendo il seguente comando da qualsiasi directory:
```
dart pub global activate flutterfire_cli
```

Passaggio 2: configura le app per utilizzare Firebase

Utilizza la CLI FlutterFire per configurare le tue app Flutter in modo che si connettano a Firebase.

Dalla directory del progetto Flutter, esegui il seguente comando per avviare il flusso di lavoro di configurazione dell'app:

flutterfire configure

Cosa fa questo workflow flutterfire configure ?

Il flusso di lavoro flutterfire configure esegue le seguenti operazioni:

Ti chiede di selezionare le piattaforme (iOS, Android, web) supportate nella tua app Flutter. Per ogni piattaforma selezionata, la CLI FlutterFire crea una nuova app Firebase nel tuo progetto Firebase.

Puoi scegliere di utilizzare un progetto Firebase esistente o di crearne uno nuovo. Se hai già registrato app in un progetto Firebase esistente, la CLI FlutterFire tenterà di associarle in base alla configurazione attuale del progetto Flutter.

Nota:ecco alcuni suggerimenti su come configurare e gestire il tuo progetto Firebase:

Consulta le nostre best practice per aggiungere app a un progetto Firebase, incluso come gestire più varianti.

Attiva Google Analytics nel tuo progetto, in modo da usufruire di un'esperienza ottimale utilizzando molti prodotti Firebase, come Crashlytics e Remote Config.

Crea un file di configurazione di Firebase (firebase_options.dart) e lo aggiunge alla directory lib/.

Nota: questo file di configurazione di Firebase contiene identificatori univoci, ma non segreti, per ogni piattaforma selezionata.
Visita la pagina Informazioni sui progetti Firebase per saperne di più su questo file di configurazione.

(per Crashlytics o Performance Monitoring su Android) Aggiunge i plug-in Gradle specifici del prodotto richiesti alla tua app Flutter.

Nota: affinché la CLI FlutterFire aggiunga il plug-in Gradle appropriato, il plug-in Flutter del prodotto deve essere già importato nella tua app Flutter.

Dopo l'esecuzione iniziale di flutterfire configure, devi eseguire di nuovo il comando ogni volta che:

Inizia a supportare una nuova piattaforma nella tua app Flutter.
Inizia a utilizzare un nuovo servizio o prodotto Firebase nella tua app Flutter, soprattutto se inizi a utilizzare l'accesso con Google, Crashlytics, Performance Monitoring o Realtime Database.

Se esegui di nuovo il comando, la configurazione Firebase dell'app Flutter viene aggiornata e (per Android) vengono aggiunti automaticamente i plug-in Gradle richiesti all'app.

Passaggio 3: inizializza Firebase nella tua app

Dalla directory del progetto Flutter, esegui il seguente comando per installare il plug-in principale:
```
flutter pub add firebase_core
```
Dalla directory del progetto Flutter, esegui questo comando per assicurarti che la configurazione Firebase della tua app Flutter sia aggiornata:
```
flutterfire configure
```
Nel file lib/main.dart, importa il plug-in Firebase Core e il file di configurazione che hai generato in precedenza:
```
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
```

Inoltre, nel file lib/main.dart, inizializza Firebase utilizzando l'oggetto DefaultFirebaseOptions esportato dal file di configurazione:

WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());

Ricrea l'applicazione Flutter:
```
flutter run
```

Se preferisci utilizzare un progetto demo, puoi avviare Firebase Emulator e nel file lib/main.dart inizializzare Firebase utilizzando demoProjectId (deve iniziare con demo-):

await Firebase.initializeApp(
  demoProjectId: "demo-project-id",
);

Passaggio 4: aggiungi i plug-in Firebase

Accedi a Firebase nella tua app Flutter tramite i vari plug-in Firebase Flutter, uno per ogni prodotto Firebase (ad esempio: Cloud Firestore, Authentication, Analytics e così via).

Poiché Flutter è un framework multipiattaforma, ogni plug-in Firebase è applicabile per le piattaforme Apple, Android e web. Pertanto, se aggiungi un plug-in Firebase alla tua app Flutter, questo verrà utilizzato dalle versioni Apple, Android e web della tua app.

Ecco come aggiungere un plug-in Firebase Flutter:

Dalla directory del progetto Flutter, esegui questo comando:
```
flutter pub add PLUGIN_NAME
```
Dalla directory del progetto Flutter, esegui questo comando:
```
flutterfire configure
```
L'esecuzione di questo comando garantisce che la configurazione Firebase della tua app Flutter sia aggiornata e, per Crashlytics e Performance Monitoring su Android, aggiunge i plug-in Gradle richiesti alla tua app.
Al termine, ricompila il progetto Flutter:
```
flutter run
```

Ecco fatto. Le tue app Flutter sono registrate e configurate per utilizzare Firebase.

Considerazioni speciali per la creazione di app web

Supporto di Trusted Types

L'SDK Firebase per Flutter supporta l'utilizzo di Trusted Types per prevenire attacchi XSS basati sul DOM (lato client). Quando attivi l'applicazione dei tipi attendibili per la tua app, l'SDK Firebase inserisce i suoi script nel DOM utilizzando criteri personalizzati per i tipi attendibili, denominati flutterfire-firebase_core, flutterfire-firebase_auth e così via.

Disattivare l'inserimento automatico dell'SDK Firebase JavaScript

Per impostazione predefinita, l'SDK Firebase Flutter inserisce automaticamente l'SDK Firebase JavaScript durante la creazione per il web. Se non vuoi che l'SDK Firebase JavaScript venga inserito automaticamente, puoi procedere nel seguente modo:

Ignora lo script di inserimento automatico aggiungendo la seguente proprietà all'interno di un tag <script> nel file web/index.html del progetto Flutter:

<!-- Add this property inside a <script> tag within your "web/index.html" file in your Flutter project -->
<!-- Put in the names of all the plugins you wish to ignore: -->
window.flutterfire_ignore_scripts = ['analytics', 'firestore'];

Carica lo script manualmente utilizzando una delle seguenti opzioni:

Opzione 1: aggiungi l'SDK in modo esplicito al file web/index.html, all'interno del callback window.addEventListener:

  window.addEventListener('load', async function (ev) {
    window.firebase_firestore = await import("https://www.gstatic.com/firebasejs/12.13.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/12.13.0/firebase-analytics.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

Opzione 2: scarica il codice dell'SDK Firebase JavaScript del plug-in dal dominio gstatic e salvalo in un file JavaScript da conservare nel tuo progetto e caricare manualmente:

  // "web/my-analytics.js" & "web/my-firestore.js" file loaded as a script into your "web/index.html" file:
  window.addEventListener('load', async function (ev) {
    window.firebase_analytics = await import("./my-analytics.js");
    window.firebase_firestore = await import("./my-firestore.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

Plug-in disponibili

Prodotto	Nome plug-in	Altro Apple (macOS, ecc.)	Windows
Firebase AI Logic ¹	`firebase_ai`	beta
Analytics	`firebase_analytics`	beta
App Check	`firebase_app_check`	beta
Authentication	`firebase_auth`	beta	beta
Cloud Firestore	`cloud_firestore`	beta	beta
Cloud Functions	`cloud_functions`	beta
Cloud Messaging	`firebase_messaging`	beta
Cloud Storage	`firebase_storage`	beta	beta
Crashlytics	`firebase_crashlytics`	beta
SQL Connect ²	`firebase_data_connect`
Dynamic Links	`firebase_dynamic_links`
In-App Messaging	`firebase_in_app_messaging`
Firebase installazioni	`firebase_app_installations`	beta
ML Model Downloader	`firebase_ml_model_downloader`	beta
Performance Monitoring	`firebase_performance`
Realtime Database	`firebase_database`	beta
Remote Config	`firebase_remote_config`	beta

^{1 Firebase AI Logic in precedenza era chiamato
"Vertex AI in Firebase" con il plug-in
firebase_vertexai.}

^{2 Firebase SQL Connect in precedenza era chiamato
"Firebase Data Connect".}

Passaggi successivi

Fai esperienza pratica con il codelab Firebase Flutter.
Preparati a lanciare la tua app:
- Configura avvisi sul budget per il tuo progetto nella console Google Cloud.
- Monitora la dashboard Utilizzo e fatturazione nella console Firebase per avere un quadro generale dell'utilizzo del tuo progetto in più servizi Firebase.
- Esamina l'elenco di controllo per il lancio di Firebase.