將 Firebase 新增到您的 Flutter 應用

先決條件

如果您還沒有 Flutter 應用程序,您可以完成入門:測試驅動,使用您喜歡的編輯器或 IDE 創建新的 Flutter 應用程式。

步驟 1 :安裝所需的命令列工具

  1. 如果尚未安裝,請安裝 Firebase CLI

  2. 執行以下命令,使用您的 Google 帳戶登入 Firebase:

    firebase login
    
  3. 透過從任意目錄執行以下命令來安裝 FlutterFire CLI:

    dart pub global activate flutterfire_cli
    

第 2 步:設定您的應用程式以使用 Firebase

使用 FlutterFire CLI 配置 Flutter 應用程式以連接到 Firebase。

從 Flutter 專案目錄中,執行下列命令來啟動應用程式設定工作流程:

flutterfire configure


第 3 步:在您的應用程式中初始化 Firebase

  1. 從 Flutter 專案目錄中,執行以下命令來安裝核心外掛程式:

    flutter pub add firebase_core
    
  2. 從 Flutter 專案目錄中執行以下命令以確保 Flutter 應用程式的 Firebase 設定是最新的:

    flutterfire configure
    
  3. lib/main.dart檔案中,導入 Firebase 核心插件和先前產生的設定檔:

    import 'package:firebase_core/firebase_core.dart';
    import 'firebase_options.dart';
    
  4. 同樣在lib/main.dart檔案中,使用設定檔匯出的DefaultFirebaseOptions物件初始化 Firebase:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  5. 重建您的 Flutter 應用程式:

    flutter run
    

第 4 步:新增 Firebase 插件

您可以透過各種Firebase Flutter 外掛程式在 Flutter 應用程式中存取 Firebase,每個 Firebase 產品對應一個外掛程式(例如:Cloud Firestore、驗證、分析等)。

由於 Flutter 是一個多平台框架,因此每個 Firebase 外掛程式都適用於 Apple、Android 和 Web 平台。因此,如果您將任何 Firebase 外掛程式新增到您的 Flutter 應用程式中,您的應用程式的 Apple、Android 和 Web 版本都將使用該外掛程式。

新增 Firebase Flutter 外掛的方法如下:

  1. 從 Flutter 專案目錄執行以下命令:

    flutter pub add PLUGIN_NAME
  2. 從 Flutter 專案目錄執行以下命令:

    flutterfire configure
    

    執行此命令可確保您的 Flutter 應用程式的 Firebase 配置是最新的,並且對於 Android 上的 Crashlytics 和效能監控,將所需的 Gradle 插件新增到您的應用程式中。

  3. 完成後,重建您的 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外掛程式附帶了一個範例程式

  1. 開啟您已設定為使用 Firebase 的 Flutter 應用程式(請參閱本頁上的說明)。

  2. 存取應用程式的lib目錄,然後刪除現有的main.dart檔案。

  3. 從 Google Analytics範例程式儲存庫中,將以下兩個檔案複製並貼上到應用程式的lib目錄:

    • main.dart
    • tabs_page.dart
  4. 運行您的 Flutter 應用程式。

  5. Firebase 控制台中前往您套用的 Firebase 項目,然後點擊左側導覽列中的Analytics

    1. 點擊儀表板。如果 Analytics 正常運作,儀表板會在「過去 30 分鐘內的活躍用戶」面板中顯示活躍用戶(填充此面板可能需要一些時間)。

    2. 按一下“調試視圖” 。啟用該功能以查看範例程式產生的所有事件。

有關設定 Analytics 的更多信息,請訪問iOS+Androidweb的入門指南。

下一步