Aggiungi Firebase alla tua app Flutter


Prerequisiti

  • Installa l'editor o l'IDE che preferisci.

  • Configura un dispositivo Apple fisico o utilizza un simulatore per eseguire l'app.

  • Assicurati che l'app Flutter abbia come target le seguenti versioni della piattaforma o versioni successive:

    • iOS 13
    • macOS 10.15

  • 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 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 ancora 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 il seguente 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 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 di base:

    flutter pub add firebase_core

  2. Dalla directory del progetto Flutter, esegui il seguente comando per assicurarti che la configurazione di 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. 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 l'emulatore Firebase e inizializzare Firebase nel file lib/main.dart utilizzando demoProjectId (dovrebbe 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 per le piattaforme Apple, Android e web. Pertanto, se aggiungi un plug-in Firebase alla tua app Flutter, 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 il seguente comando:

    flutter pub add PLUGIN_NAME

  2. Dalla directory del progetto Flutter, esegui il seguente 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 all'app.

  3. Al termine, ricostruisci 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
ML Model Downloader 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 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 poi fai clic su Analytics nel riquadro 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 per compilare questo riquadro).

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