Dodawanie Firebase do aplikacji we Flutterze


Wymagania wstępne

Jeśli nie masz jeszcze aplikacji Flutter, możesz wykonać czynności opisane w artykule Wprowadzenie: testowanie, aby utworzyć nową aplikację Flutter w wybranym edytorze lub środowisku IDE.

Krok 1. Zainstaluj wymagane narzędzia wiersza poleceń

  1. Jeśli jeszcze tego nie zrobiono, zainstaluj interfejs wiersza poleceń Firebase.

  2. Zaloguj się w Firebase za pomocą konta Google, uruchamiając to polecenie:

    firebase login

  3. Zainstaluj interfejs wiersza poleceń FlutterFire, uruchamiając to polecenie w dowolnym katalogu:

    dart pub global activate flutterfire_cli

Krok 2. Skonfiguruj aplikacje pod kątem używania Firebase

Użyj interfejsu wiersza poleceń FlutterFire, aby skonfigurować aplikacje Flutter pod kątem łączenia się z Firebase.

W katalogu projektu Flutter uruchom to polecenie, aby rozpocząć proces konfigurowania aplikacji:

flutterfire configure


Krok 3. Zainicjuj Firebase w aplikacji

  1. W katalogu projektu Flutter uruchom to polecenie, aby zainstalować wtyczkę podstawową:

    flutter pub add firebase_core

  2. W katalogu projektu Flutter uruchom to polecenie, aby upewnić się, że konfiguracja Firebase w aplikacji Flutter jest aktualna:

    flutterfire configure

  3. W pliku lib/main.dart zaimportuj podstawową wtyczkę Firebase i wygenerowany wcześniej plik konfiguracyjny:

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

  4. W pliku lib/main.dart zainicjuj Firebase za pomocą obiektu DefaultFirebaseOptions wyeksportowanego przez plik konfiguracji:

    WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());

  5. Przebuduj aplikację Flutter:

    flutter run

Jeśli wolisz użyć projektu demonstracyjnego, możesz uruchomić emulator Firebase i w pliku lib/main.dart zainicjować Firebase za pomocą demoProjectId (powinien zaczynać się od demo-):

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

Krok 4. Dodaj wtyczki Firebase

Dostęp do Firebase w aplikacji Flutter uzyskujesz za pomocą różnych wtyczek Firebase Flutter, po jednej dla każdego produktu Firebase (np. Cloud Firestore, Authentication, Analytics itp.).

Flutter to platforma wieloplatformowa, więc każdy wtyczka Firebase ma zastosowanie na platformach Apple, Android i internetowych. Jeśli więc dodasz do aplikacji Flutter dowolną wtyczkę Firebase, będzie ona używana przez wersje aplikacji na Apple, Androida i w internecie.

Aby dodać wtyczkę Firebase Flutter:

  1. W katalogu projektu Flutter uruchom to polecenie:

    flutter pub add PLUGIN_NAME

  2. W katalogu projektu Flutter uruchom to polecenie:

    flutterfire configure

    Uruchomienie tego polecenia zapewnia, że konfiguracja Firebase w aplikacji Flutter jest aktualna, a w przypadku Crashlytics i Performance Monitoring na Androidzie dodaje do aplikacji wymagane wtyczki Gradle.

  3. Po zakończeniu ponownie skompiluj projekt Flutter:

    flutter run

To już wszystko Twoje aplikacje Flutter są zarejestrowane i skonfigurowane do korzystania z Firebase.

Dostępne wtyczki

Usługa Nazwa wtyczki iOS Android Sieć Inne urządzenia Apple
(macOS itp.)		 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 instalacje firebase_app_installations
beta
Pobieranie modeli ML firebase_ml_model_downloader
beta
Performance Monitoring firebase_performance
Realtime Database firebase_database
beta
Remote Config firebase_remote_config
beta

1 Firebase AI Logic nazywała się wcześniej „Vertex AI in Firebase” i korzystała z wtyczki firebase_vertexai.

Wypróbuj przykładową aplikację z Analytics

Podobnie jak wszystkie pakiety, wtyczka firebase_analytics zawiera przykładowy program.

  1. Otwórz aplikację Flutter, która jest już skonfigurowana do korzystania z Firebase (instrukcje znajdziesz na tej stronie).

  2. Otwórz katalog lib aplikacji, a następnie usuń istniejący plik main.dart.

  3. Z Google Analytics repozytorium przykładowych programów skopiuj i wklej do katalogu lib aplikacji te 2 pliki:

    • main.dart
    • tabs_page.dart

  4. Uruchom aplikację Flutter.

  5. Otwórz projekt Firebase swojej aplikacji w Firebase konsoli, a potem w menu po lewej stronie kliknij Analytics.

    1. Kliknij Panel. Jeśli Analytics działa prawidłowo, w panelu „Aktywni użytkownicy w ostatnich 30 minutach” na panelu wyświetli się aktywny użytkownik (wypełnienie tego panelu może zająć trochę czasu).

    2. Kliknij DebugView. Włącz tę funkcję, aby zobaczyć wszystkie zdarzenia wygenerowane przez program przykładowy.

Więcej informacji o konfigurowaniu Analytics znajdziesz w przewodnikach dla początkujących dotyczących iOS, Androida i internetu.

Dalsze kroki