Dodawanie Firebase do aplikacji Flutter


Wymagania wstępne

  • Zainstaluj preferowany edytor lub IDE.

  • Zainstaluj Flutter dla swojego systemu operacyjnego, w tym:

    • Pakiet SDK Flutter
    • Biblioteki pomocnicze
    • Oprogramowanie i pakiety SDK związane z poszczególnymi platformami

  • Zaloguj się w Firebase, korzystając ze swojego konta Google.

Jeśli nie masz jeszcze aplikacji Flutter, możesz utworzyć nową aplikację Flutter, korzystając z pomocy w rozpoczęciu pracy: testowanie aplikacji i ulubionego edytora lub środowiska IDE.

Krok 1. Zainstaluj wymagane narzędzia wiersza poleceń.

  1. Zainstaluj interfejs wiersza poleceń Firebase (jeśli jeszcze go nie masz).

  2. Zaloguj się do Firebase, korzystając ze swojego konta Google, uruchamiając następujące polecenie:

    firebase login

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

    dart pub global activate flutterfire_cli

Krok 2. Skonfiguruj aplikacje, aby korzystały z Firebase

Użyj interfejsu wiersza poleceń FlutterFire, aby skonfigurować połączenia aplikacji Flutter z Firebase.

Aby rozpocząć konfigurację aplikacji, uruchom w katalogu projektu Flutter to polecenie:

flutterfire configure


Krok 3. Zainicjuj Firebase w swojej aplikacji

  1. Aby zainstalować podstawowy wtyczkę, uruchom w katalogu projektu Flutter to polecenie:

    flutter pub add firebase_core

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

    flutterfire configure

  3. Do pliku lib/main.dart zaimportuj główną wtyczkę Firebase oraz wygenerowany wcześniej plik konfiguracji:

    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. Zbuduj ponownie aplikację Flutter:

    flutter run

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

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

Krok 4. Dodaj wtyczki Firebase

Dostęp do Firebase w aplikacji Flutter uzyskuje się przez różne wtyczki Firebase Flutter, po jednej na każdą usługę Firebase (np. Cloud Firestore, Authentication, Analytics itp.).

Flutter to platforma wieloplatformowa, więc każda wtyczka Firebase ma zastosowanie do Apple, Androida i platform internetowych. Jeśli dodasz do aplikacji Flutter dowolny wtyczkę Firebase, będzie ona używana przez wersje aplikacji na Apple, Androida i internet.

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. W przypadku wersji Crashlytics i Performance Monitoring na Androida dodawane są 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
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 instalacji firebase_app_installations
beta
Narzędzie do pobierania modeli 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

Wypróbuj przykładową aplikację z użyciem 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. Przejdź do katalogu lib aplikacji, a następnie usuń istniejący plik main.dart.

  3. Z repozytorium przykładowego programu Google Analytics skopiuj i wklej te 2 pliki do katalogu lib aplikacji:

    • main.dart
    • tabs_page.dart

  4. Uruchom aplikację Flutter.

  5. W konsoli Firebase otwórz projekt Firebase aplikacji, a potem w panelu nawigacyjnym po lewej stronie kliknij Analytics.

    1. Kliknij Panel. Jeśli funkcja Analytics działa prawidłowo, w panelu „Użytkownicy aktywni w ciągu ostatnich 30 minut” będzie widoczny aktywny użytkownik (wypełnienie tego panelu może trochę potrwać).

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

Więcej informacji o konfigurowaniu Analytics znajdziesz w przewodnikach dla iOS+, Androida i sieci.

Dalsze kroki