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 w swoim systemie operacyjnym, w tym:
- Pakiet SDK Flutter
- Biblioteki pomocnicze
- Oprogramowanie i pakiety SDK na poszczególne platformy

Wymagania wstępne dotyczące poszczególnych platform:

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ć Cloud Messaging?

W przypadku Cloud Messaging na platformach Apple wymagania wstępne są następujące:

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 > Funkcje).

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
- Androida w wersji 7.0 lub nowszej.

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ń

Jeśli jeszcze tego nie zrobiono, zainstaluj interfejs wiersza poleceń Firebase.
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 w istniejącym projekcie w Firebase masz już zarejestrowane aplikacje, interfejs wiersza poleceń FlutterFire spróbuje je dopasować na podstawie bieżącej konfiguracji projektu Flutter.

Uwaga: poniżej znajdziesz kilka wskazówek dotyczących konfigurowania projektu Firebase i zarządzania nim:

Zapoznaj się z naszymi sprawdzonymi metodami dodawania aplikacji do projektu Firebase, w tym z informacjami o tym, jak obsługiwać wiele 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 FlutterFire CLI mógł dodać odpowiednią wtyczkę Gradle, wtyczka Flutter produktu musi być już zaimportowana do aplikacji we Flutterze.

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 zapewnia, że konfiguracja Firebase w aplikacji Flutter jest aktualna, a (w przypadku Androida) automatycznie dodaje do aplikacji 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ż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 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.
Po zakończeniu ponownie skompiluj projekt Flutter:
```
flutter run
```

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

Specjalne uwagi dotyczące tworzenia aplikacji internetowych

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

Obsługa typów zaufanych

Pakiet Firebase SDK na potrzeby Fluttera obsługuje typy zaufane, które pomagają 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'];

Załaduj 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.0.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/13.0.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 ładowany 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 Google Cloud konsoli.
- Monitoruj panel Wykorzystanie i rozliczenia w Firebase konsoli, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
- Zapoznaj się z listą kontrolną dotyczącą uruchamiania Firebase.