Dodawanie Firebase do aplikacji Flutter


Wymagania wstępne

  • Zainstaluj preferowany edytor lub IDE.

  • Skonfiguruj fizyczne urządzenie Apple lub uruchom aplikację za pomocą symulatora.

  • Upewnij się, że Twoja aplikacja Flutter jest kierowana na te wersje platformy lub nowsze:

    • iOS 13
    • macOS 10.15

  • Zainstaluj Flutter w danym systemie operacyjnym, w tym:

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

  • Zaloguj się w Firebase, używając konta Google.

Jeśli nie masz jeszcze aplikacji Flutter, możesz utworzyć nową aplikację Flutter, korzystając z pomocy w rozpoczęciu: 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ę w Firebase za pomocą konta Google, wykonując to 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 pod kątem używania Firebase.

Aby skonfigurować aplikacje Flutter do łączenia się z Firebase, użyj interfejsu wiersza poleceń FlutterFire.

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

flutterfire configure


Krok 3. W aplikacji zainicjuj Firebase

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

    flutter pub add firebase_core

  2. Aby mieć pewność, że konfiguracja Firebase w aplikacji Flutter jest aktualna, uruchom w katalogu projektu Flutter to polecenie:

    flutterfire configure

  3. W pliku lib/main.dart zaimportuj wcześniej wygenerowany podstawowy wtyczkę Firebase i 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 i 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 uzyskujesz za pomocą różnych wtyczek Firebase Flutter, po jednym dla każdego produktu Firebase (np. Cloud Firestore, Authentication, Analytics itd.).

Flutter to platforma wieloplatformowa, więc każdy wtyczka Firebase jest odpowiednia do platform Apple, Android i 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, a w przypadku wersji Crashlytics i Performance Monitoring na Androida doda 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
Program 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 została już skonfigurowana do korzystania z Firebase (patrz instrukcje na tej stronie).

  2. Otwórz katalog 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 menu nawigacyjnym po lewej stronie kliknij Analizy.

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

    2. Kliknij Widok debugowania. 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