Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Pierwsze kroki z Firebase w projekcie Flutter

Wymagania wstępne

Zainstaluj preferowany edytor lub IDE.
Zainstaluj Fluttera na swoim systemie operacyjnym, np.:
- Flutter SDK
- Biblioteki pomocnicze
- Oprogramowanie i pakiety SDK na konkretne platformy

Wymagania wstępne dotyczące platformy:

Apple

Skonfiguruj fizyczne urządzenie Apple lub użyj symulatora, aby uruchomić aplikację.
Upewnij się, że aplikacja Flutter jest przeznaczona na te wersje platformy lub nowsze:
- iOS 15
- macOS 11

Czy chcesz użyć aplikacji Cloud Messaging?

Wymagania wstępne dotyczące Cloud Messaging na platformach Apple:

Skonfiguruj fizyczne urządzenie Apple.

Uzyskaj klucz uwierzytelniania usługi Apple Push Notification dla swojego konta dewelopera Apple.

Włącz powiadomienia push w Xcode w sekcji App > Capabilities (Aplikacja > Możliwości).

Android

Skonfiguruj urządzenie lub emulator do uruchamiania aplikacji. Emulatory muszą używać obrazu emulatora z Google Play.
Upewnij się, że Twoja aplikacja spełnia te wymagania:
- Docelowy poziom interfejsu API: 24 (Nougat) lub wyższy
- ma system Android 7.0 lub nowszy,

Sieć

Brak wymagań wstępnych dotyczących platformy

Jeśli nie masz jeszcze aplikacji Flutter, możesz wykonać czynności opisane w artykule Get Started: Test Drive (Pierwsze kroki: jazda próbna), aby utworzyć nową aplikację Flutter za pomocą preferowanego edytora lub IDE.

Krok 1. Zainstaluj wymagane narzędzia wiersza poleceń

Zainstaluj interfejs wiersza poleceń Firebase, jeśli jeszcze nie został zainstalowany.
Zaloguj się w Firebase za pomocą konta Google, uruchamiając to polecenie:
```
firebase login
```
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 do łączenia się z Firebase.

Aby rozpocząć proces konfiguracji aplikacji, w katalogu projektu Flutter uruchom to polecenie:

flutterfire configure

Co robi ten flutterfire configure przepływ pracy?

Przepływ pracy flutterfire configure wykonuje te czynności:

Prosi o wybranie platform (iOS, Android, internet), które są obsługiwane w aplikacji Flutter. Dla każdej wybranej platformy interfejs wiersza poleceń FlutterFire tworzy nową aplikację w Firebase w projekcie w Firebase.

Możesz wybrać istniejący projekt w Firebase lub utworzyć nowy projekt w Firebase. Jeśli masz już aplikacje zarejestrowane w istniejącym projekcie w Firebase, interfejs wiersza poleceń FlutterFire spróbuje je dopasować na podstawie bieżącej konfiguracji projektu Flutter.

Uwaga: oto kilka wskazówek dotyczących konfigurowania projektu w Firebase i zarządzania nim:

Zapoznaj się ze sprawdzonymi metodami dodawania aplikacji do projektu w Firebase, w tym z informacjami o obsłudze wielu wariantów.

Włącz w projekcie Google Analytics, aby zapewnić optymalne działanie wielu usług Firebase, takich jak Crashlytics i Remote Config.

Tworzy plik konfiguracji Firebase (firebase_options.dart) i dodaje go do katalogu lib/.

Uwaga: ten plik konfiguracyjny Firebase zawiera unikalne, ale nie tajne identyfikatory każdej wybranej platformy.
Więcej informacji o tym pliku konfiguracyjnym znajdziesz w artykule Informacje o projektach w Firebase.

(w przypadku Crashlytics lub Performance Monitoring na Androidzie) Dodaje do aplikacji we Flutterze wymagane wtyczki Gradle dla konkretnych usług.

Uwaga: aby interfejs wiersza poleceń FlutterFire mógł dodać odpowiednią wtyczkę Gradle, wtyczka Flutter usługi musi być już zaimportowana do aplikacji Flutter.

Po pierwszym uruchomieniu flutterfire configure musisz ponownie uruchomić polecenie za każdym razem, gdy:

Zacznij obsługiwać nową platformę w aplikacji Flutter.
Zaczniesz używać nowej usługi lub nowego produktu Firebase w aplikacji Flutter, zwłaszcza jeśli zaczniesz używać logowania przez Google, Crashlytics, Performance Monitoring lub Realtime Database.

Ponowne uruchomienie polecenia spowoduje, że konfiguracja Firebase aplikacji Flutter będzie aktualna, a (w przypadku Androida) do aplikacji zostaną automatycznie dodane wszystkie wymagane wtyczki Gradle.

Krok 3. Zainicjuj Firebase w aplikacji

Aby zainstalować podstawową wtyczkę, w katalogu projektu Flutter uruchom to polecenie:
```
flutter pub add firebase_core
```
Aby upewnić się, że konfiguracja Firebase aplikacji Flutter jest aktualna, uruchom w katalogu projektu Flutter to polecenie:
```
flutterfire configure
```
W pliku lib/main.dart zaimportuj podstawową wtyczkę Firebase i wygenerowany wcześniej plik konfiguracji:
```
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
```

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

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

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żdej usługi Firebase (np. Cloud Firestore, Authentication, Analytics).

Flutter to platforma wieloplatformowa, więc każda wtyczka Firebase jest przeznaczona na platformy Apple, Android i internetowe. Jeśli więc dodasz do aplikacji Flutter dowolną wtyczkę Firebase, będzie ona używana przez wersje aplikacji na Apple, Androida i sieć.

Aby dodać wtyczkę Firebase Flutter:

W katalogu projektu Flutter uruchom to polecenie:
```
flutter pub add PLUGIN_NAME
```
W katalogu projektu Flutter uruchom to polecenie:
```
flutterfire configure
```
Uruchomienie tego polecenia zapewnia, że konfiguracja Firebase aplikacji Flutter jest aktualna, a w przypadku Crashlytics i Performance Monitoring na Androidzie dodaje do aplikacji wymagane wtyczki Gradle.
Gdy to zrobisz, ponownie skompiluj projekt Flutter:
```
flutter run
```

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

Specjalne uwagi dotyczące tworzenia aplikacji internetowych

Podczas kierowania na platformę internetową zapoznaj się z tymi opcjami konfiguracji.

Obsługa typów zaufanych

Pakiet Firebase SDK dla Fluttera obsługuje typy zaufane, aby zapobiegać atakom XSS opartym na DOM (po stronie klienta). Gdy włączysz egzekwowanie typów zaufanych w aplikacji, pakiet SDK Firebase wstrzykuje skrypty do modelu DOM, używając niestandardowych zasad typów zaufanych o nazwach flutterfire-firebase_core, flutterfire-firebase_auth itd.

Wyłączanie automatycznego wstrzykiwania pakietu Firebase JavaScript SDK

Domyślnie pakiet Firebase Flutter SDK automatycznie wstrzykuje pakiet Firebase JavaScript SDK podczas kompilowania na potrzeby internetu. Jeśli nie chcesz, aby pakiet Firebase JavaScript SDK był automatycznie wstrzykiwany, możesz wykonać te czynności:

Zignoruj skrypt automatycznego wstrzykiwania, dodając tę właściwość w tagu <script> w pliku web/index.html w projekcie Flutter:

<!-- Add this property inside a <script> tag within your "web/index.html" file in your Flutter project -->
<!-- Put in the names of all the plugins you wish to ignore: -->
window.flutterfire_ignore_scripts = ['analytics', 'firestore'];

Wczytaj skrypt ręcznie, korzystając z jednej z tych opcji:

Opcja 1. Dodaj pakiet SDK bezpośrednio do pliku web/index.html w wywołaniu zwrotnym window.addEventListener:

  window.addEventListener('load', async function (ev) {
    window.firebase_firestore = await import("https://www.gstatic.com/firebasejs/13.1.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/13.1.0/firebase-analytics.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

Opcja 2. Pobierz kod pakietu Firebase JavaScript SDK wtyczki z domeny gstatic i zapisz go w pliku JavaScript, który będzie przechowywany w projekcie i wczytywany ręcznie:

  // "web/my-analytics.js" & "web/my-firestore.js" file loaded as a script into your "web/index.html" file:
  window.addEventListener('load', async function (ev) {
    window.firebase_analytics = await import("./my-analytics.js");
    window.firebase_firestore = await import("./my-firestore.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

Dostępne wtyczki

Usługa	Nazwa wtyczki	Inne urządzenia Apple (macOS itp.)	Windows
Firebase AI Logic ¹	`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
In-App Messaging	`firebase_in_app_messaging`
Firebase instalacje	`firebase_app_installations`	beta
Performance Monitoring	`firebase_performance`
Realtime Database	`firebase_database`	beta
Remote Config	`firebase_remote_config`	beta
SQL Connect ²	`firebase_data_connect`
WYCOFANE LUB NIEOBSŁUGIWANE BIBLIOTEKI
Dynamic Links	`firebase_dynamic_links`
Narzędzie do pobierania modeli ML	`firebase_ml_model_downloader`	beta

^{1 Firebase AI Logic wcześniej nosił nazwę „Vertex AI in Firebase” i korzystał z wtyczki firebase_vertexai.}

^{2 Firebase SQL Connect wcześniej nosił nazwę „Firebase Data Connect”.}

Dalsze kroki

Zdobądź praktyczne doświadczenie dzięki ćwiczeniom z programowania dotyczącym Firebase Flutter.
Przygotuj się do opublikowania aplikacji:
- Skonfiguruj alerty dotyczące budżetu dla projektu w konsoli Google Cloud.
- Monitoruj panel Korzystanie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase.
- Zapoznaj się z listą kontrolną dotyczącą uruchamiania Firebase.