將 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、驗證、分析等）。

由於 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`	貝塔
ML模型下載器	`firebase_ml_model_downloader`	貝塔
效能監控	`firebase_performance`
即時資料庫	`firebase_database`	貝塔
遠端配置	`firebase_remote_config`	貝塔

嘗試使用 Analytics 的範例應用程式

與所有軟體包一樣， firebase_analytics外掛程式附帶了一個範例程式。

開啟您已設定為使用 Firebase 的 Flutter 應用程式（請參閱本頁上的說明）。
存取應用程式的lib目錄，然後刪除現有的main.dart檔案。
從 Google Analytics範例程式儲存庫中，將以下兩個檔案複製並貼上到應用程式的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 啟動清單。