Добавьте Firebase в свое приложение Flutter
Предварительные условия
Установите предпочитаемый вами редактор или IDE .
Настройте физическое устройство Apple или используйте симулятор для запуска приложения.
Для Cloud Messaging на платформах Apple необходимо выполнить следующие требования:
- Настройте физическое устройство Apple .
- Получите ключ аутентификации Apple Push Notification для своей учетной записи Apple Developer .
- Включите push-уведомления в Xcode в разделе «Приложение» > «Возможности» .
Убедитесь, что ваше приложение Flutter ориентировано на следующие версии платформы или более поздние:
- iOS 13
- macOS 10.15
Установите Flutter для вашей конкретной операционной системы, включая следующее:
- Флаттер SDK
- Поддержка библиотек
- Программное обеспечение и SDK для конкретной платформы
Войдите в Firebase, используя свою учетную запись Google.
Если у вас еще нет приложения Flutter, вы можете пройти курс «Начало работы: тест-драйв», чтобы создать новое приложение Flutter с помощью предпочитаемого вами редактора или IDE.
Шаг 1. Установите необходимые инструменты командной строки.
Если вы еще этого не сделали, установите Firebase CLI .
Войдите в Firebase, используя свою учетную запись Google, выполнив следующую команду:
firebase login
Установите интерфейс командной строки 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 в своем приложении.
В каталоге проекта 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
, экспортированный файлом конфигурации:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
Перестройте приложение 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:
В каталоге проекта Flutter выполните следующую команду:
flutter pub add PLUGIN_NAME
В каталоге проекта Flutter выполните следующую команду:
flutterfire configure
Выполнение этой команды гарантирует, что конфигурация Firebase вашего приложения Flutter обновлена, а для Crashlytics и Performance Monitoring на Android в ваше приложение добавляются необходимые плагины Gradle.
После завершения перестройте проект 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 | бета | ||||
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 | бета | ||||
Vertex AI in Firebase | firebase_vertexai | бета |
Попробуйте пример приложения с Analytics
Как и все пакеты, плагин firebase_analytics
поставляется с примером программы .
Откройте приложение Flutter, которое вы уже настроили для использования Firebase (см. инструкции на этой странице).
Откройте каталог
lib
приложения, затем удалите существующий файлmain.dart
.Из репозитория примеров программ Google Analytics скопируйте и вставьте следующие два файла в каталог
lib
вашего приложения:-
main.dart
-
tabs_page.dart
-
Запустите приложение Flutter.
Перейдите к проекту Firebase вашего приложения в консоли Firebase , затем нажмите «Аналитика» на панели навигации слева.
Нажмите Панель мониторинга . Если Analytics работает правильно, на панели мониторинга отображается активный пользователь на панели «Пользователи, активные за последние 30 минут» (для заполнения этой панели может потребоваться время).
Нажмите «ОтладкаView» . Включите эту функцию, чтобы увидеть все события, генерируемые примером программы.
Дополнительную информацию о настройке Analytics см. в руководствах по началу работы для iOS+ , Android и веб-версии .
Следующие шаги
Получите практический опыт работы с Firebase Flutter Codelab .
Подготовьтесь к запуску приложения:
- Настройте оповещения о бюджете для своего проекта в консоли Google Cloud .
- Отслеживайте панель «Использование и выставление счетов» в консоли Firebase , чтобы получить общую картину использования вашего проекта в нескольких сервисах Firebase.
- Ознакомьтесь с контрольным списком запуска Firebase .