將 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 | 貝塔 | |||
雲端 Firestore | 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 example program repository中,將以下兩個文件複製並粘貼到您應用程序的
lib
目錄中:-
main.dart
-
tabs_page.dart
-
運行你的 Flutter 應用程序。
在Firebase 控制台中轉到您應用的 Firebase 項目,然後單擊左側導航欄中的Analytics 。
有關設置 Analytics 的更多信息,請訪問iOS+ 、 Android和Web的入門指南。
下一步
親身體驗Firebase Flutter Codelab 。
準備啟動您的應用程序:
- 在 Google Cloud Console 中為您的項目設置預算提醒。
- 監控 Firebase 控制台中的使用情況和計費儀表板,以全面了解您的項目在多個 Firebase 服務中的使用情況。
- 查看Firebase 啟動清單。