Aggiungi Firebase alla tua app Flutter


Prerequisiti

  • Installa il tuo editor o IDE che preferisci.

  • Installa Flutter per il tuo sistema operativo specifico, inclusi i seguenti:

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

  • Accedi a Firebase utilizzando il tuo account .

Se non hai ancora un'app Flutter, puoi completare la Iniziato: test drive su crea una nuova app Flutter usando il tuo editor o IDE preferito.

Passaggio 1: installa gli strumenti a riga di comando richiesti

  1. Se non l'hai già fatto, installa l'interfaccia a riga di comando 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 questo comando da qualsiasi directory:

    dart pub global activate flutterfire_cli

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

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

Dalla directory del progetto Flutter, esegui questo comando per avviare flusso di lavoro per la 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 della tua 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. Sempre nel file lib/main.dart, inizializza Firebase utilizzando il metodo Oggetto DefaultFirebaseOptions esportato dal file di configurazione:

    await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

  5. Ricrea l'applicazione Flutter:

    flutter run

Se preferisci usare un progetto dimostrativo, puoi avviare l'emulatore di Firebase e nel tuo file lib/main.dart inizializza Firebase utilizzando demoProjectId (deve iniziare con demo-):

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

Passaggio 4: aggiungi i plug-in di Firebase

Puoi accedere a Firebase nell'app Flutter tramite i vari plug-in 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 per Apple, Android e piattaforme web. Quindi, se aggiungi plug-in Firebase nell'app Flutter, verrà utilizzata dalle versioni Apple, Android e web la 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 è aggiornato e, per Crashlytics e Performance Monitoring su Android, aggiunge i plug-in Gradle richiesti per la 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
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 è dotato di 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 l'elemento main.dart esistente .

  3. Da Google Analytics repository dei programmi di esempio, copia e incolla i due file seguenti 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. Clic Dashboard: Se Analytics funziona correttamente, la dashboard mostra un utente attivo nel riquadro "Utenti attivi negli ultimi 30 minuti" (potrebbe essere necessario del tempo per compilare questo riquadro).

    2. Fai clic su DebugView. Attiva la funzionalità per per vedere 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