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


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

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

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

    • Флаттер SDK
    • Поддержка библиотек
    • Программное обеспечение и SDK для конкретной платформы

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

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

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

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

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

    firebase login

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

    dart pub global activate flutterfire_cli

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

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

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

flutterfire configure

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

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

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

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

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


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

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

    flutter pub add firebase_core

  2. В каталоге проекта Flutter выполните следующую команду, чтобы убедиться, что конфигурация Firebase вашего приложения 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 Андроид Интернет Другое Apple
(macOS и т. д.)		 Окна
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
бета
Data Connect 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
бета
Вершинный ИИ в Firebase firebase_vertexai
бета

Попробуйте пример приложения с 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. Нажмите «ОтладкаView» . Включите эту функцию, чтобы увидеть все события, генерируемые примером программы.

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

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