Добавьте Firebase в ваше Flutter-приложение


Предварительные требования

  • Установите предпочитаемый вами редактор или IDE .

  • Установите Flutter для вашей операционной системы, включая следующие компоненты:

    • Flutter SDK
    • Библиотеки-партнеры
    • Программное обеспечение и SDK, специфичные для конкретной платформы

  • Войдите в Firebase, используя свою учетную запись Google.

Если у вас еще нет приложения Flutter, вы можете пройти этап «Начало работы: Тестовая версия» , чтобы создать новое приложение Flutter, используя предпочитаемый вами редактор или IDE.

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

  1. Если вы еще этого не сделали, установите Firebase CLI .

  2. Войдите в Firebase, используя свою учетную запись Google, выполнив следующую команду:

    firebase login

  3. Установите FlutterFire CLI, выполнив следующую команду из любой директории:

    dart pub global activate flutterfire_cli

Шаг 2 : Настройте свои приложения для использования Firebase.

Используйте FlutterFire CLI для настройки ваших Flutter-приложений для подключения к Firebase.

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

flutterfire configure


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

  1. Для установки основного плагина выполните следующую команду в каталоге вашего проекта Flutter:

    flutter pub add firebase_core

  2. Чтобы убедиться в актуальности конфигурации Firebase в вашем Flutter-приложении, выполните следующую команду в каталоге вашего проекта Flutter:

    flutterfire configure

  3. В файле lib/main.dart импортируйте основной плагин Firebase и сгенерированный ранее конфигурационный файл:

    import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

  4. Также в файле lib/main.dart инициализируйте Firebase, используя объект DefaultFirebaseOptions , экспортируемый из файла конфигурации:

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

  5. Пересоберите ваше 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 и веб-версий. Таким образом, если вы добавите любой плагин Firebase в свое приложение Flutter, он будет использоваться версиями вашего приложения для Apple, Android и веб-версиями.

Вот как добавить плагин Firebase Flutter:

  1. В каталоге вашего проекта Flutter выполните следующую команду: 

    flutter pub add PLUGIN_NAME

  2. В каталоге вашего проекта Flutter выполните следующую команду: 

    flutterfire configure

    Выполнение этой команды гарантирует актуальность конфигурации Firebase в вашем Flutter-приложении и, для Crashlytics и Performance Monitoring на Android, добавляет необходимые плагины Gradle в ваше приложение.

  3. После завершения пересоберите свой проект Flutter: 

    flutter run

Всё готово! Ваши Flutter-приложения зарегистрированы и настроены для использования Firebase.

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

Продукт Название плагина iOS Android Веб Другие яблоки
(macOS и т. д.)		 Windows
Firebase AI Logic 1 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
бета
SQL Connect 2 firebase_data_connect
Dynamic Links firebase_dynamic_links
In-App Messaging firebase_in_app_messaging
Установка Firebase firebase_app_installations
бета
Программа для загрузки моделей машинного обучения firebase_ml_model_downloader
бета
Performance Monitoring firebase_performance
Realtime Database firebase_database
бета
Remote Config firebase_remote_config
бета

1. Ранее Firebase AI Logic назывался " Vertex AI in Firebase " и имел плагин firebase_vertexai .

2. Ранее Firebase SQL Connect назывался " Firebase Data Connect ".

Попробуйте пример приложения с Analytics

Как и все пакеты, плагин firebase_analytics поставляется с примером программы .

  1. Откройте Flutter-приложение, которое вы уже настроили для использования Firebase (см. инструкции на этой странице).

  2. Перейдите в каталог lib приложения, затем удалите существующий файл main.dart .

  3. Скопируйте и вставьте следующие два файла из репозитория примеров программ Google Analytics в каталог lib вашего приложения:

    • main.dart
    • tabs_page.dart

  4. Запустите ваше Flutter-приложение.

  5. В консоли Firebase перейдите в проект Firebase вашего приложения, затем в левой панели навигации нажмите «Аналитика» .

    1. Нажмите «Панель управления» . Если Analytics работает корректно, на панели «Пользователи, активные за последние 30 минут» на панели управления отображается активный пользователь (заполнение этой панели может занять некоторое время).

    2. Нажмите DebugView . Включите эту функцию, чтобы увидеть все события, сгенерированные примером программы.

Для получения дополнительной информации о настройке Analytics посетите руководства по началу работы для iOS+ , Android и веб-версии .

Следующие шаги