將 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、驗證、分析等)。
由於 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 | 貝塔 | |||
ML模型下載器 | 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 啟動清單。