Aggiungi Firebase alla tua app 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
  • Accedi a Firebase utilizzando il tuo Account Google.

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

  1. Se non l'hai ancora fatto, installa la CLI di Firebase.

  2. Accedi a Firebase utilizzando il tuo Account Google eseguendo il seguente comando:

    firebase login
    
  3. 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


Passaggio 3: inizializza Firebase nella tua app

  1. Dalla directory del progetto Flutter, esegui il seguente comando per installare il plug-in principale:

    flutter pub add firebase_core
    
  2. Dalla directory del progetto Flutter, esegui il comando seguente per assicurarti che la configurazione Firebase dell'app Flutter sia aggiornata:

    flutterfire configure
    
  3. 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';
    
  4. 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());
    
  5. Ricrea l'applicazione Flutter:

    flutter run
    

Se preferisci utilizzare un progetto dimostrativo, 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:

  1. Dalla directory del progetto Flutter, esegui questo comando:

    flutter pub add PLUGIN_NAME
  2. 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.

  3. Al termine, ricompila il progetto Flutter:

    flutter run
    

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

Plug-in disponibili

Prodotto Nome plug-in iOS Android Web Altri prodotti Apple
(macOS e così via)
Windows
Firebase AI Logic 1 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
Data 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.

Prova un'app di esempio con Analytics

Come tutti i pacchetti, il plug-in firebase_analytics viene fornito con un programma di esempio.

  1. Apri un'app Flutter che hai già configurato per utilizzare Firebase (vedi le istruzioni in questa pagina).

  2. Accedi alla directory lib dell'app, quindi elimina il file main.dart esistente.

  3. Dal Google Analytics repository del programma di esempio, copia e incolla i due file seguenti nella directory lib della tua app:

    • main.dart
    • tabs_page.dart
  4. Esegui l'app Flutter.

  5. Vai al progetto Firebase della tua app nella console Firebase, poi fai clic su Analytics nel menu di navigazione a sinistra.

    1. Fai clic su Dashboard. Se Analytics funziona correttamente, la dashboard mostra un utente attivo nel riquadro "Utenti attivi negli ultimi 30 minuti" (potrebbe essere necessario del tempo prima che questo riquadro venga compilato).

    2. Fai clic su DebugView. Attiva la funzionalità per visualizzare tutti gli eventi generati dal programma di esempio.

Per ulteriori informazioni sulla configurazione di Analytics, consulta le guide introduttive per iOS+, Android e web.

Passaggi successivi