将 Firebase 添加到您的 Flutter 应用
先决条件
安装您喜欢的编辑器或 IDE 。
为您的特定操作系统安装 Flutter ,包括以下内容:
- 颤振 SDK
- 支持库
- 特定于平台的软件和 SDK
使用您的 Google 帐户登录 Firebase 。
如果您还没有 Flutter 应用程序,您可以完成入门:测试驱动以使用您喜欢的编辑器或 IDE 创建一个新的 Flutter 应用程序。
第 1 步:安装所需的命令行工具
如果您还没有安装 Firebase CLI 。
通过运行以下命令,使用您的 Google 帐户登录 Firebase:
firebase login
通过从任何目录运行以下命令来安装 FlutterFire CLI:
dart pub global activate flutterfire_cli
第 2 步:配置您的应用以使用 Firebase
使用 FlutterFire CLI 配置您的 Flutter 应用以连接到 Firebase。
在 Flutter 项目目录中,运行以下命令来启动应用配置工作流程:
flutterfire configure
flutterfire configure
工作流程执行以下操作:
要求您选择 Flutter 应用程序支持的平台(iOS、Android、Web)。对于每个选定的平台,FlutterFire CLI 都会在您的 Firebase 项目中创建一个新的 Firebase 应用。
您可以选择使用现有的 Firebase 项目或创建新的 Firebase 项目。如果您已经在现有 Firebase 项目中注册了应用,FlutterFire CLI 将尝试根据您当前的 Flutter 项目配置匹配它们。
创建一个 Firebase 配置文件 (
firebase_options.dart
) 并将其添加到您的lib/
目录中。(用于 Android 上的 Crashlytics 或性能监控)将所需的特定于产品的 Gradle 插件添加到您的 Flutter 应用程序中。
第 3 步:在您的应用中初始化 Firebase
在 Flutter 项目目录中,运行以下命令来安装核心插件:
flutter pub add firebase_core
在 Flutter 项目目录中,运行以下命令以确保 Flutter 应用的 Firebase 配置是最新的:
flutterfire configure
在您的
lib/main.dart
文件中,导入 Firebase 核心插件和您之前生成的配置文件:import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
同样在您的
lib/main.dart
文件中,使用配置文件导出的DefaultFirebaseOptions
对象初始化 Firebase:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
重建你的 Flutter 应用程序:
flutter run
第 4 步:添加 Firebase 插件
您可以通过各种Firebase Flutter 插件在 Flutter 应用程序中访问 Firebase,每个 Firebase 产品(例如:Cloud Firestore、Authentication、Analytics 等)一个。
由于 Flutter 是一个多平台框架,因此每个 Firebase 插件都适用于 Apple、Android 和 Web 平台。因此,如果您将任何 Firebase 插件添加到您的 Flutter 应用程序,它将被您的应用程序的 Apple、Android 和 Web 版本使用。
以下是添加 Firebase Flutter 插件的方法:
在 Flutter 项目目录中,运行以下命令:
flutter pub add PLUGIN_NAME
在 Flutter 项目目录中,运行以下命令:
flutterfire configure
运行此命令可确保您的 Flutter 应用的 Firebase 配置是最新的,并且对于 Android 上的 Crashlytics 和性能监控,将所需的 Gradle 插件添加到您的应用中。
完成后,重新构建您的 Flutter 项目:
flutter run
你都准备好了!您的 Flutter 应用已注册并配置为使用 Firebase。
可用插件
产品 | 插件名称 | iOS | 安卓 | 网络 | 其他苹果 (macOS 等) |
---|---|---|---|---|---|
分析 | firebase_analytics | 测试版 | |||
应用检查 | firebase_app_check | 测试版 | |||
验证 | firebase_auth | 测试版 | |||
云防火墙 | cloud_firestore | 测试版 | |||
云函数 | cloud_functions | 测试版 | |||
云消息传递 | firebase_messaging | 测试版 | |||
云储存 | firebase_storage | 测试版 | |||
崩溃分析器 | firebase_crashlytics | 测试版 | |||
动态链接 | firebase_dynamic_links | ||||
应用内消息 | firebase_in_app_messaging | ||||
Firebase 安装 | firebase_app_installations | 测试版 | |||
机器学习模型下载器 | firebase_ml_model_downloader | 测试版 | |||
性能监控 | firebase_performance | ||||
实时数据库 | firebase_database | 测试版 | |||
远程配置 | firebase_remote_config | 测试版 |
使用 Analytics 试用示例应用程序
与所有软件包一样, firebase_analytics
插件附带一个示例程序。
打开您已配置为使用 Firebase 的 Flutter 应用(请参阅此页面上的说明)。
访问应用程序的
lib
目录,然后删除现有的main.dart
文件。从 Google Analytics示例程序存储库中,将以下两个文件复制粘贴到您应用的
lib
目录中:-
main.dart
-
tabs_page.dart
-
运行你的 Flutter 应用。
在Firebase 控制台中转到您应用的 Firebase 项目,然后点击左侧导航栏中的Analytics 。
有关设置 Analytics 的更多信息,请访问iOS+ 、 Android和Web的入门指南。
下一步
获得Firebase Flutter Codelab的实践经验。
准备启动您的应用程序:
- 在 Google Cloud Console 中为您的项目设置预算提醒。
- 监控 Firebase 控制台中的使用情况和计费信息中心,以全面了解您的项目在多个 Firebase 服务中的使用情况。
- 查看Firebase 启动清单。