將 Firebase 新增至 Flutter 應用程式
事前準備
安裝您偏好的 Editor 或 IDE。
根據您的作業系統安裝 Flutter,包括:
- 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
步驟 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、驗證、Analytics (分析) 等。
由於 Flutter 是多平台架構,因此每個 Firebase 外掛程式都適用於 Apple、Android 和網路平台。因此,如果您將任何 Firebase 外掛程式新增至 Flutter 應用程式,Apple、Android 和網頁版應用程式也會使用該外掛程式。
新增 Firebase Flutter 外掛程式的方法如下:
從 Flutter 專案目錄中執行下列指令:
flutter pub add PLUGIN_NAME
從 Flutter 專案目錄中執行下列指令:
flutterfire configure
執行這個指令可確保 Flutter 應用程式的 Firebase 設定是最新狀態;若是 Android 的 Crashlytics 和 Performance Monitoring,請將必要的 Gradle 外掛程式新增至應用程式。
完成後,請重新建構 Flutter 專案:
flutter run
大功告成!您的 Flutter 應用程式已註冊並設定使用 Firebase。
可用的外掛程式
產品 | 外掛程式名稱 | iOS | Android | Web | 其他 Apple (macOS 等) |
Windows |
---|---|---|---|---|---|---|
數據分析 | firebase_analytics |
Beta 版 | ||||
應用程式檢查 | firebase_app_check |
Beta 版 | ||||
身分驗證 | firebase_auth |
Beta 版 | Beta 版 | |||
Cloud Firestore | cloud_firestore |
Beta 版 | Beta 版 | |||
Cloud Functions | cloud_functions |
Beta 版 | ||||
雲端通訊 | firebase_messaging |
Beta 版 | ||||
Cloud Storage | firebase_storage |
Beta 版 | Beta 版 | |||
Crashlytics | firebase_crashlytics |
Beta 版 | ||||
Dynamic Links | firebase_dynamic_links |
|||||
應用程式內通訊 | firebase_in_app_messaging |
|||||
Firebase 安裝 | firebase_app_installations |
Beta 版 | ||||
機器學習模型下載工具 | firebase_ml_model_downloader |
Beta 版 | ||||
監控效能 | firebase_performance |
|||||
即時資料庫 | firebase_database |
Beta 版 | ||||
遠端設定 | firebase_remote_config |
Beta 版 | ||||
Vertex AI for Firebase | firebase_vertexai |
Beta 版 |
試用應用程式數據分析搭配 Analytics (分析)
和所有套件一樣,firebase_analytics
外掛程式隨附範例程式。
開啟已設定使用 Firebase 的 Flutter 應用程式 (請參閱本頁的操作說明)。
存取應用程式的
lib
目錄,然後刪除現有的main.dart
檔案。從 Google Analytics (分析) 範例程式存放區複製以下兩個檔案,並貼到應用程式的
lib
目錄中:main.dart
tabs_page.dart
執行 Flutter 應用程式。
在 Firebase 控制台中前往應用程式的 Firebase 專案,然後按一下左側導覽面板中的「Analytics」(分析)。
按一下「Dashboard」(資訊主頁)。如果 Analytics (分析) 正常運作,資訊主頁會在「過去 30 分鐘的活躍使用者」面板中顯示活躍使用者 (可能要過一段時間才能填入這個面板)。
按一下「DebugView」。啟用這項功能即可查看範例程式產生的所有事件。
如要進一步瞭解如何設定 Analytics (分析),請參閱 iOS+、Android 和網站的入門指南。
後續步驟
透過 Firebase Flutter 程式碼研究室獲得實務經驗。
準備推出應用程式:
- 在 Google Cloud 控制台中,為專案設定預算快訊。
- 在 Firebase 控制台中監控「用量與計費」資訊主頁,掌握專案在多項 Firebase 服務中的整體用量。
- 詳閱 Firebase 推出檢查清單。