Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как начать работу с Firebase в проекте Flutter

Требования

Установите редактор или интегрированную среду разработки.
Установите Flutter для своей операционной системы, в том числе:
- Flutter SDK
- Поддерживаемые библиотеки
- Программное обеспечение и SDK для определенных платформ

Требования для разных платформ

Apple

Настройте физическое устройство Apple или используйте симулятор для запуска приложения.
Убедитесь, что ваше приложение Flutter предназначено для следующих версий платформы или более поздних:
- iOS 15
- macOS 11

Хотите использовать Cloud Messaging?

Для использования Cloud Messaging на платформах Apple необходимо следующее:

Настройте физическое устройство Apple.

Получите ключ аутентификации службы push-уведомлений Apple для аккаунта разработчика Apple.

Включите push-уведомления в Xcode в разделе App > Capabilities.

Android

Настройте устройство или эмулятор для запуска приложения. Эмуляторы должны использовать образ эмулятора с Google Play.
Убедитесь, что ваше приложение соответствует следующим требованиям:
- Целевой уровень API – 23 (Marshmallow) или выше.
- устройство с Android 6.0 или более поздней версии;

Веб-приложение

Нет требований, связанных с определенной платформой

Если у вас ещё нет приложения Flutter, вы можете создать его с помощью предпочитаемого редактора или IDE, выполнив инструкции в разделе Начало работы: пробный запуск.

Шаг 1. Установите необходимые инструменты командной строки

Если вы ещё не сделали этого, установите интерфейс командной строки Firebase.
Войдите в Firebase с помощью аккаунта Google, выполнив следующую команду:
```
firebase login
```
Установите интерфейс командной строки FlutterFire, выполнив следующую команду в любом каталоге:
```
dart pub global activate flutterfire_cli
```

Шаг 2. Настройте приложения для работы с Firebase

Используйте интерфейс командной строки FlutterFire, чтобы настроить подключение приложений Flutter к Firebase.

В каталоге проекта Flutter выполните следующую команду, чтобы запустить процесс настройки приложения:

flutterfire configure

Что делает этот flutterfire configure рабочий процесс?

Рабочий процесс flutterfire configure выполняет следующие действия:

Предлагает выбрать платформы (iOS, Android, веб), поддерживаемые в приложении Flutter. Для каждой выбранной платформы FlutterFire CLI создает новое приложение Firebase в проекте Firebase.

Вы можете выбрать существующий проект Firebase или создать новый. Если в существующем проекте Firebase уже зарегистрированы приложения, FlutterFire CLI попытается сопоставить их на основе текущей конфигурации проекта Flutter.

Примечание. Вот несколько советов по настройке проекта Firebase и управлению им:

Ознакомьтесь с нашими рекомендациями по добавлению приложений в проект Firebase, в том числе о том, как работать с несколькими вариантами.

Включите Google Analytics в проекте. Это позволит вам использовать многие продукты Firebase, например Crashlytics и Remote Config, с максимальной эффективностью.

Создает файл конфигурации Firebase (firebase_options.dart) и добавляет его в каталог lib/.

Примечание. Файл конфигурации Firebase содержит уникальные общедоступные идентификаторы, используемые в проекте.
Подробнее об этом файле конфигурации можно узнать в статье Проекты Firebase.

(для Crashlytics или Performance Monitoring на Android) добавляет в приложение Flutter необходимые плагины Gradle для определенного продукта.

Примечание. Чтобы FlutterFire CLI добавил подходящий плагин Gradle, плагин Flutter продукта должен быть уже импортирован в приложение Flutter.

После первого запуска команды flutterfire configure вам нужно будет выполнять ее повторно каждый раз, когда вы:

Как добавить поддержку новой платформы в приложение Flutter
Начните использовать в приложении Flutter новый сервис или продукт Firebase, особенно если вы начали использовать вход с аккаунтом Google, Crashlytics, Performance Monitoring или Realtime Database.

Повторный запуск команды гарантирует, что конфигурация Firebase в приложении Flutter актуальна, а также автоматически добавляет в приложение все необходимые плагины Gradle (для Android).

Шаг 3. Инициализируйте Firebase в приложении

В каталоге проекта Flutter выполните следующую команду, чтобы установить основной плагин:
```
flutter pub add firebase_core
```
В каталоге проекта Flutter выполните следующую команду, чтобы убедиться, что конфигурация Firebase в приложении Flutter актуальна:
```
flutterfire configure
```
В файле lib/main.dart импортируйте основной плагин Firebase и файл конфигурации, созданный ранее:
```
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
```
Также в файле lib/main.dart инициализируйте Firebase, используя объект DefaultFirebaseOptions, экспортированный из файла конфигурации:
```
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());
```
Пересоберите приложение Flutter:
```
flutter run
```

Если вы хотите использовать тестовый проект, запустите эмулятор Firebase и в файле lib/main.dart инициализируйте Firebase с помощью demoProjectId (он должен начинаться с demo-):

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

Шаг 4. Добавьте плагины Firebase

Вы можете получить доступ к Firebase в приложении Flutter с помощью различных плагинов Firebase для Flutter, по одному для каждого продукта Firebase (например, Cloud Firestore, Authentication, Analytics и т. д.).

Поскольку Flutter – это многоплатформенный фреймворк, каждый плагин Firebase подходит для платформ Apple, Android и веб-платформ. Поэтому, если вы добавите в приложение Flutter какой-либо плагин Firebase, он будет использоваться в версиях приложения для Apple, Android и веб-версии.

Чтобы добавить плагин Firebase Flutter, выполните следующие действия:

В каталоге проекта Flutter выполните следующую команду:
```
flutter pub add PLUGIN_NAME
```
В каталоге проекта Flutter выполните следующую команду:
```
flutterfire configure
```
Выполнение этой команды гарантирует, что конфигурация Firebase в приложении Flutter будет актуальной, а для версий Crashlytics и Performance Monitoring на Android добавит в приложение необходимые плагины Gradle.
После этого пересоберите проект Flutter:
```
flutter run
```

Готово! Приложения Flutter зарегистрированы и настроены для использования Firebase.

Особенности создания веб-приложений

При настройке таргетинга на веб-платформу учитывайте следующие параметры:

Поддержка Trusted Types

Firebase SDK для Flutter поддерживает использование Trusted Types, которые помогают предотвратить XSS-атаки на основе DOM (клиентские). Когда вы включаете принудительное использование доверенных типов для своего приложения, Firebase SDK внедряет свои скрипты в DOM, используя специальные правила доверенных типов, названные flutterfire-firebase_core, flutterfire-firebase_auth и т. д.

Как отключить автоматическое внедрение Firebase JavaScript SDK

По умолчанию Firebase Flutter SDK автоматически внедряет Firebase JavaScript SDK при создании веб-приложения. Если вы не хотите, чтобы Firebase JavaScript SDK внедрялся автоматически, сделайте следующее:

Чтобы игнорировать скрипт автоматической вставки, добавьте следующее свойство в тег <script> в файле web/index.html проекта 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'];

Загрузите скрипт вручную, используя один из следующих вариантов:

Вариант 1. Добавьте SDK в файл web/index.html в обратный вызов window.addEventListener:

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

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

Вариант 2. Скачайте код Firebase JavaScript SDK из домена gstatic и сохраните его в файл JavaScript, который будет храниться в вашем проекте и загружаться вручную:

  // "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

Доступные плагины

Товар	Название плагина	Другие устройства Apple (macOS и т. д.)	Windows
Firebase AI Logic ¹	`firebase_ai`	бета-версия
Analytics	`firebase_analytics`	бета-версия
App Check	`firebase_app_check`	бета-версия
Authentication	`firebase_auth`	бета-версия	бета-версия
Cloud Firestore	`cloud_firestore`	бета-версия	бета-версия
Cloud Functions	`cloud_functions`	бета-версия
Cloud Messaging	`firebase_messaging`	бета-версия
Cloud Storage	`firebase_storage`	бета-версия	бета-версия
Crashlytics	`firebase_crashlytics`	бета-версия
In-App Messaging	`firebase_in_app_messaging`
Firebase установок	`firebase_app_installations`	бета-версия
Performance Monitoring	`firebase_performance`
Realtime Database	`firebase_database`	бета-версия
Remote Config	`firebase_remote_config`	бета-версия
SQL Connect ²	`firebase_data_connect`
УСТАРЕВШИЕ ИЛИ НЕПОДДЕРЖИВАЕМЫЕ БИБЛИОТЕКИ
Dynamic Links	`firebase_dynamic_links`
ML Model Downloader	`firebase_ml_model_downloader`	бета-версия

^{1 Firebase AI Logic ранее назывался "Vertex AI in Firebase" с плагином firebase_vertexai.}

^{2 Firebase SQL Connect ранее назывался "Firebase Data Connect".}

Дальнейшие действия

Выполните практическую работу по Firebase Flutter.
Подготовьтесь к запуску приложения:
- Настройте оповещения о бюджете для своего проекта в консоли Google Cloud.
- Отслеживайте панель управления "Использование и оплата" в консоли Firebase, чтобы получать общую информацию об использовании проекта в разных сервисах Firebase.
- Изучите контрольный список запуска Firebase.