Чтобы переводить контент на ваш предпочитаемый язык, 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: 24 (Nougat) или выше.
- устройство с Android 7.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.
Вы начинаете использовать новый сервис или продукт Firebase в приложении Flutter, особенно если это функция входа с аккаунтом Google, Crashlytics, Performance Monitoring или Realtime Database.

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

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

Чтобы установить основной плагин, выполните в каталоге проекта Flutter следующую команду:
```
flutter pub add firebase_core
```
Чтобы убедиться, что конфигурация Firebase в приложении Flutter актуальна, выполните следующую команду в каталоге проекта 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/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

Вариант 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`
Загрузчик моделей машинного обучения	`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.