Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

將 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
測試版
雲防火牆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示例程序存儲庫中,將以下兩個文件複製粘貼到您應用的lib目錄中:

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

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

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

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

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

下一步