將 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工作流程是做什麼的？

flutterfire configure工作流程執行以下操作：
要求您選擇 Flutter 應用支持的平台（iOS、Android、Web）。對於每個選定的平台，FlutterFire CLI 在您的 Firebase 項目中創建一個新的 Firebase 應用程序。
您可以選擇使用現有的 Firebase 項目或創建新的 Firebase 項目。如果您已經在現有的 Firebase 項目中註冊了應用程序，FlutterFire CLI 將嘗試根據您當前的 Flutter 項目配置來匹配它們。
注意：以下是有關設置和管理 Firebase 項目的一些提示：
查看我們將應用程序添加到 Firebase 項目的最佳實踐，包括如何處理多個變體。
在您的項目中啟用 Google Analytics ，這使您能夠在使用許多 Firebase 產品（例如 Crashlytics 和 Remote Config）時獲得最佳體驗。
創建一個 Firebase 配置文件 ( firebase_options.dart ) 並將其添加到您的lib/目錄。
注意：此 Firebase 配置文件包含您選擇的每個平台的唯一但非秘密標識符。
訪問了解 Firebase 項目以了解有關此配置文件的更多信息。
（適用於 Android 上的 Crashlytics 或性能監控）將所需的特定於產品的 Gradle 插件添加到您的 Flutter 應用程序。
注意：為了讓 FlutterFire CLI 添加合適的 Gradle 插件，產品的 Flutter 插件必須已經導入到您的 Flutter 應用中。

在首次運行flutterfire configure之後，您需要在任何時候重新運行該命令：

開始在您的 Flutter 應用程序中支持新平台。
開始在您的 Flutter 應用程序中使用新的 Firebase 服務或產品，尤其是當您開始使用 Google、Crashlytics、性能監控或實時數據庫登錄時。

重新運行該命令可確保您的 Flutter 應用的 Firebase 配置是最新的，並且（對於 Android）自動將任何所需的 Gradle 插件添加到您的應用中。

第 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、Authentication、Analytics 等）。

由於 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。

可用插件

產品	插件名稱	其他蘋果（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插件附帶一個示例程序。

打開您已配置為使用 Firebase 的 Flutter 應用程序（請參閱本頁上的說明）。
訪問應用程序的lib目錄，然後刪除現有的main.dart文件。
從 Google Analytics example program repository中，將以下兩個文件複製並粘貼到您應用程序的lib目錄中：
- main.dart
- tabs_page.dart
運行你的 Flutter 應用程序。
在Firebase 控制台中轉到您應用的 Firebase 項目，然後單擊左側導航欄中的Analytics 。
1. 單擊儀表板。如果 Analytics 正常工作，儀表板會在“過去 30 分鐘內活躍的用戶”面板中顯示活躍用戶（這可能需要一些時間來填充此面板）。
2. 單擊調試視圖。啟用該功能以查看示例程序生成的所有事件。

有關設置 Analytics 的更多信息，請訪問iOS+ 、 Android和Web的入門指南。

下一步

親身體驗Firebase Flutter Codelab 。
準備啟動您的應用程序：
- 在 Google Cloud Console 中為您的項目設置預算提醒。
- 監控 Firebase 控制台中的使用情況和計費儀表板，以全面了解您的項目在多個 Firebase 服務中的使用情況。
- 查看Firebase 啟動清單。