Добавьте Firebase в свое приложение Flutter
Предпосылки
Установите предпочитаемый вами редактор или IDE .
Установите Flutter для вашей операционной системы, включая следующее:
- Пакет SDK для Flutter
- Поддержка библиотек
- Программное обеспечение и SDK для конкретных платформ
Войдите в Firebase, используя свой аккаунт Google.
Если у вас еще нет приложения Flutter, вы можете выполнить « Начало работы: тест-драйв» , чтобы создать новое приложение Flutter с помощью предпочитаемого вами редактора или IDE.
Шаг 1 : Установите необходимые инструменты командной строки.
Если вы еще этого не сделали, установите Firebase CLI .
Войдите в Firebase, используя свою учетную запись Google, выполнив следующую команду:
firebase login
Установите FlutterFire CLI, выполнив следующую команду из любого каталога:
dart pub global activate flutterfire_cli
Шаг 2 : Настройте свои приложения для использования Firebase
Используйте FlutterFire CLI для настройки приложений Flutter для подключения к Firebase.
Из каталога проекта Flutter выполните следующую команду, чтобы начать рабочий процесс конфигурации приложения:
flutterfire configure
Рабочий процесс
flutterfire configure
выполняет следующие действия:
Просит вас выбрать платформы (iOS, Android, Web), поддерживаемые вашим приложением Flutter. Для каждой выбранной платформы FlutterFire CLI создает новое приложение Firebase в вашем проекте Firebase.
Вы можете выбрать либо использование существующего проекта Firebase, либо создание нового проекта Firebase. Если у вас уже есть приложения, зарегистрированные в существующем проекте Firebase, FlutterFire CLI попытается сопоставить их на основе текущей конфигурации проекта 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
, экспортированного файлом конфигурации: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 и веб-платформ. Таким образом, если вы добавите любой плагин 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 | андроид | Веб | Другое яблоко (macOS и т. д.) | Окна |
---|---|---|---|---|---|---|
Firebase AI Логика 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 | бета | ||||
Data Connect | firebase_data_connect | |||||
Dynamic Links | firebase_dynamic_links | |||||
In-App Messaging | firebase_in_app_messaging | |||||
Установки Firebase | firebase_app_installations | бета | ||||
Загрузчик моделей ML | 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
.
Попробуйте пример приложения с Analytics
Как и все пакеты, плагин firebase_analytics
поставляется с примером программы .
Откройте приложение Flutter, которое вы уже настроили для использования Firebase (см. инструкции на этой странице).
Откройте каталог
lib
приложения, затем удалите существующий файлmain.dart
.Из репозитория примеров программ Google Analytics скопируйте и вставьте следующие два файла в каталог
lib
вашего приложения:-
main.dart
-
tabs_page.dart
-
Запустите приложение Flutter.
Перейдите к проекту Firebase вашего приложения в консоли Firebase , затем нажмите «Аналитика» в левой навигационной панели.
Нажмите Панель управления . Если Analytics работает правильно, панель управления показывает активного пользователя на панели «Пользователи, активные за последние 30 минут» (заполнение этой панели может занять некоторое время).
Нажмите DebugView . Включите функцию, чтобы увидеть все события, сгенерированные примером программы.
Для получения дополнительной информации о настройке Analytics посетите руководства по началу работы для iOS+ , Android и веб-приложений .
Следующие шаги
Получите практический опыт работы с Firebase Flutter Codelab .
Подготовьтесь к запуску вашего приложения:
- Настройте оповещения о бюджете для вашего проекта в консоли Google Cloud .
- Отслеживайте панель управления использованием и выставлением счетов в консоли Firebase , чтобы получить общую картину использования вашего проекта в различных службах Firebase.
- Ознакомьтесь с контрольным списком запуска Firebase .