將 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、Authentication、Analytics 等)。

由於 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
貝塔
機器學習模型下載器firebase_ml_model_downloader
貝塔
性能監控firebase_performance
實時數據庫firebase_database
貝塔
遠程配置firebase_remote_config
貝塔

使用 Analytics 試用示例應用程序

與所有軟件包一樣, firebase_analytics插件附帶一個示例程序

  1. 打開您已配置為使用 Firebase 的 Flutter 應用程序(請參閱本頁上的說明)。

  2. 訪問應用程序的lib目錄,然後刪除現有的main.dart文件。

  3. 從 Google Analytics example program repository中,將以下兩個文件複製並粘貼到您應用程序的lib目錄中:

    • main.dart
    • tabs_page.dart
  4. 運行你的 Flutter 應用程序。

  5. Firebase 控制台中轉到您應用的 Firebase 項目,然後單擊左側導航欄中的Analytics

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

    2. 單擊調試視圖。啟用該功能以查看示例程序生成的所有事件。

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

下一步