Firebase zu Ihrer Flutter-App hinzufügen


Vorbereitung

Wenn Sie noch keine Flutter-App haben, können Sie die Kurzanleitung: Testlauf durchführen, um eine neue Flutter-App mit Ihrem bevorzugten Editor oder Ihrer bevorzugten IDE zu erstellen.

Schritt 1: Erforderliche Befehlszeilentools installieren

  1. Installieren Sie das Firebase-CLI, falls noch nicht geschehen.

  2. Melden Sie sich mit folgendem Befehl mit Ihrem Google-Konto in Firebase an:

    firebase login
    
  3. Installieren Sie die FlutterFire CLI, indem Sie den folgenden Befehl in einem beliebigen Verzeichnis ausführen:

    dart pub global activate flutterfire_cli
    

Schritt 2: Apps für die Verwendung von Firebase konfigurieren

Mit der FlutterFire-Befehlszeile können Sie Ihre Flutter-Apps so konfigurieren, dass sie eine Verbindung zu Firebase herstellen.

Führen Sie im Verzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um den Workflow für die App-Konfiguration zu starten:

flutterfire configure


Schritt 3: Firebase in Ihrer App initialisieren

  1. Führen Sie im Verzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Core-Plug-in zu installieren:

    flutter pub add firebase_core
    
  2. Führen Sie im Verzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um dafür zu sorgen, dass die Firebase-Konfiguration Ihrer Flutter-App auf dem neuesten Stand ist:

    flutterfire configure
    
  3. Importieren Sie in Ihrer lib/main.dart-Datei das Firebase-Kern-Plug-in und die zuvor generierte Konfigurationsdatei:

    import 'package:firebase_core/firebase_core.dart';
    import 'firebase_options.dart';
    
  4. Initialisieren Sie Firebase auch in Ihrer lib/main.dart-Datei mit dem Objekt DefaultFirebaseOptions, das von der Konfigurationsdatei exportiert wird:

    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    runApp(const MyApp());
    
  5. Erstellen Sie Ihre Flutter-Anwendung neu:

    flutter run
    

Wenn Sie lieber ein Demoprojekt verwenden möchten, können Sie den Firebase-Emulator starten und Firebase in Ihrer lib/main.dart-Datei mit demoProjectId initialisieren (die Zeile sollte mit demo- beginnen):

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

Schritt 4: Firebase-Plug-ins hinzufügen

Sie greifen in Ihrer Flutter-App über die verschiedenen Firebase-Flutter-Plug-ins auf Firebase zu. Für jedes Firebase-Produkt gibt es ein Plug-in (z. B. Cloud Firestore, Authentication, Analytics usw.).

Da Flutter ein plattformübergreifendes Framework ist, ist jedes Firebase-Plug-in für Apple-, Android- und Webplattformen anwendbar. Wenn Sie Ihrer Flutter-App also ein Firebase-Plug-in hinzufügen, wird es von den Apple-, Android- und Webversionen Ihrer App verwendet.

So fügen Sie ein Firebase-Flutter-Plug‑in hinzu:

  1. Führen Sie im Verzeichnis Ihres Flutter-Projekts den folgenden Befehl aus:

    flutter pub add PLUGIN_NAME
  2. Führen Sie im Verzeichnis Ihres Flutter-Projekts den folgenden Befehl aus:

    flutterfire configure
    

    Wenn Sie diesen Befehl ausführen, wird dafür gesorgt, dass die Firebase-Konfiguration Ihrer Flutter-App auf dem neuesten Stand ist. Außerdem werden für Crashlytics und Performance Monitoring unter Android die erforderlichen Gradle-Plug-ins zu Ihrer App hinzugefügt.

  3. Wenn Sie fertig sind, erstellen Sie Ihr Flutter-Projekt neu:

    flutter run
    

Fertig! Ihre Flutter-Apps sind registriert und für die Verwendung von Firebase konfiguriert.

Verfügbare Plug-ins

Produkt Plug‑in-Name iOS Android Web Andere Apple-Produkte
(macOS usw.)
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-Installationen 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 hieß früher „Vertex AI in Firebase“ mit dem Plug‑in firebase_vertexai.

Beispiel-App mit Analytics ausprobieren

Wie alle Pakete enthält auch das firebase_analytics-Plug-in ein Beispielprogramm.

  1. Öffnen Sie eine Flutter-App, die Sie bereits für die Verwendung von Firebase konfiguriert haben (siehe Anleitung auf dieser Seite).

  2. Rufen Sie das Verzeichnis lib der App auf und löschen Sie die vorhandene Datei main.dart.

  3. Kopieren Sie aus dem Google Analytics-Beispielprogramm-Repository die folgenden beiden Dateien in das lib-Verzeichnis Ihrer App:

    • main.dart
    • tabs_page.dart
  4. Führen Sie Ihre Flutter-App aus.

  5. Rufen Sie das Firebase-Projekt Ihrer App in der Firebase Console auf und klicken Sie dann in der linken Navigationsleiste auf Analytics.

    1. Klicken Sie auf Dashboard. Wenn Analytics ordnungsgemäß funktioniert, wird im Dashboard im Bereich „Aktive Nutzer in den letzten 30 Minuten“ ein aktiver Nutzer angezeigt. Es kann einige Zeit dauern, bis dieser Bereich gefüllt wird.

    2. Klicken Sie auf DebugView. Aktivieren Sie die Funktion, um alle Ereignisse zu sehen, die vom Beispielprogramm generiert wurden.

Weitere Informationen zum Einrichten von Analytics finden Sie in den Anleitungen für den Einstieg in iOS+, Android und Web.

Nächste Schritte