Aggiungi Firebase alla tua app Flutter


Prerequisiti

  • Installa il tuo editor o IDE che preferisci.

  • Installa Flutter per il tuo sistema operativo specifico, incluso quanto segue:

    • SDK Flutter
    • Librerie di supporto
    • Software e SDK specifici della piattaforma

  • Accedi a Firebase con il tuo Account Google.

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

Passaggio 1: installa gli strumenti a riga di comando richiesti

  1. Se non lo hai già fatto, installa l'interfaccia a riga di comando Firebase.

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

    firebase login

  3. Installa l'interfaccia a riga di comando FlutterFire eseguendo questo comando da qualsiasi directory:

    dart pub global activate flutterfire_cli

Passaggio 2: configura le app per l'utilizzo di Firebase

Usa l'interfaccia a riga di comando FlutterFire per configurare le tue app Flutter in modo che si connettano a Firebase.

Dalla directory del progetto Flutter, esegui questo 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 questo comando per installare il plug-in principale:

    flutter pub add firebase_core

  2. Dalla directory del progetto Flutter, esegui questo comando 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 generato in precedenza:

    import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

  4. 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. Ricostruisci 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 plugin Flutter di Firebase, uno per ogni prodotto Firebase (ad esempio: Cloud Firestore, Authentication, Analytics e così via).

Poiché Flutter è un framework multipiattaforma, ogni plug-in Firebase è applicabile a Apple, Android e alle piattaforme web. Pertanto, se aggiungi un plug-in Firebase alla tua app Flutter, verrà utilizzato dalle versioni Apple, Android e web dell'app.

Ecco come aggiungere un plug-in Firebase Flutter:

  1. Dalla directory del progetto Flutter, esegui il seguente 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 dell'app Flutter sia aggiornata e, per Crashlytics e Performance Monitoring su Android, aggiunge i plug-in Gradle richiesti alla tua app.

  3. Al termine, ricrea il progetto Flutter:

    flutter run

Ecco fatto. Le tue app Flutter sono registrate e configurate per l'utilizzo di Firebase.

Plug-in disponibili

Prodotto Nome plug-in iOS Android Web Altro Apple
(macOS e così via)		 Windows
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
Programma di download dei modelli ML firebase_ml_model_downloader
beta
Performance Monitoring firebase_performance
Realtime Database firebase_database
beta
Remote Config firebase_remote_config
beta
Vertex AI in Firebase firebase_vertexai
beta

Prova un'app di esempio con Analytics

Come tutti i pacchetti, il plug-in firebase_analytics include un programma di esempio.

  1. Apri un'app Flutter che hai già configurato per l'utilizzo di Firebase (leggi 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 seguenti due file nella directory lib dell'app:

    • main.dart
    • tabs_page.dart

  4. Esegui l'app Flutter.

  5. Vai al progetto Firebase della tua app nella console Firebase e 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" (la compilazione del riquadro potrebbe richiedere del tempo).

    2. Fai clic su DebugView. Abilita 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 e versioni successive, Android e web.

Passaggi successivi