Firebase
將你的 Flutter 應用程式連接到 Firebase,使用驗證、Cloud Firestore、 Firebase SQL Connect、雲端儲存、AI 功能,以及無伺服器 Dart 函式。
Firebase 是 Google 的應用程式開發平台, 為行動、網頁與桌面平台的 Flutter 應用程式提供託管的後端服務。 每項 Firebase 服務都是 pub.dev 上獨立的 Firebase Flutter 插件, 因此你可以只加入應用程式需要的服務:
| 服務 | 使用情境 | 套件 |
|---|---|---|
| Cloud Firestore | 具備即時同步與內建離線快取的 NoSQL 文件資料庫 | cloud_firestore |
| Firebase SQL Connect | 託管的 PostgreSQL 資料庫,並產生型別安全的 Dart SDK | firebase_data_connect |
| Firebase Authentication | 使用電子郵件、電話,以及 Google 或 Apple 等供應商登入 | firebase_auth |
| Cloud Storage for Firebase | 上傳與下載使用者的照片、影片與文件 | firebase_storage |
| Firebase AI Logic | 從用戶端直接存取 Gemini 與 Imagen 模型 | firebase_ai |
| Cloud Functions for Firebase | 以 JavaScript、TypeScript、Python 或 Dart(實驗性)撰寫的無伺服器後端邏輯 |
cloud_functions
(用戶端)、
firebase_functions
(伺服器端)
|
| Firebase Crashlytics | 即時崩潰回報與診斷 | firebase_crashlytics |
如需完整的支援套件與平台可用性清單, 請參考 Available Firebase Flutter plugins。
將 Flutter 應用程式連接到 Firebase
#若要將你的 Flutter 應用程式註冊到 Firebase 專案並產生 各平台的設定檔,請使用 Firebase CLI 與 FlutterFire CLI:
-
安裝 Firebase CLI,並登入你的 Google 帳戶:
firebase login -
全域安裝 FlutterFire CLI:
dart pub global activate flutterfire_cli -
在 Flutter 專案的根目錄中,加入核心插件並執行設定流程:
flutter pub add firebase_core flutterfire configure此指令會在你的 Firebase 專案中註冊各平台的應用程式, 並產生
lib/firebase_options.dart。 -
在呼叫
runApp()之前,於lib/main.dart中初始化 Firebase:dartimport 'package:firebase_core/firebase_core.dart'; import 'package:flutter/material.dart'; import 'firebase_options.dart'; void main() async { WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, ); runApp(const MyApp()); }
如需詳細的平台設定說明,請參考 Add Firebase to your Flutter app。
使用 Firebase Authentication 驗證使用者
#Firebase Authentication 支援以電子郵件與密碼、 電話號碼、匿名工作階段,以及 Google、Apple 與 GitHub 等 聯合身分供應商登入。
若要在應用程式中加入 Firebase Authentication,請安裝 firebase_auth:
flutter pub add firebase_auth
你可以搭配 StreamBuilder 監聽 FirebaseAuth.instance.authStateChanges(),
在使用者登入或登出時做出回應:
import 'package:firebase_auth/firebase_auth.dart';
import 'package:flutter/material.dart';
class AuthGate extends StatelessWidget {
const AuthGate({super.key});
@override
Widget build(BuildContext context) {
return StreamBuilder<User?>(
stream: FirebaseAuth.instance.authStateChanges(),
builder: (context, snapshot) {
if (snapshot.connectionState == ConnectionState.waiting) {
return const Center(child: CircularProgressIndicator());
}
if (snapshot.hasData) {
return HomeScreen(user: snapshot.data!);
}
// Your own sign-in UI.
return const SignInScreen();
},
);
}
}
Future<UserCredential> signInWithEmail(String email, String password) {
return FirebaseAuth.instance.signInWithEmailAndPassword(
email: email,
password: password,
);
}
想進一步了解,請參考 Get started with Firebase Authentication on Flutter,或 FirebaseUI authentication codelab。
使用 Cloud Firestore 儲存並同步 NoSQL 資料
#當你的應用程式需要可擴充的 NoSQL 資料庫,能在多個裝置間即時同步資料, 並提供離線快取與持久化時,例如聊天應用程式、協作工具, 或需要在不穩定連線下持續運作的現場服務應用程式, Cloud Firestore 是建議的預設選擇。若要比較 Cloud Firestore 與 關聯式及本機儲存選項,請參考 Choose a database for your Flutter app。
若要將 Cloud Firestore 加入專案,請執行:
flutter pub add cloud_firestore
以下範例會在 tasks 集合中新增一份任務文件,
並將即時查詢結果以串流方式顯示在 ListView 中:
import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:flutter/material.dart';
Future<void> addTask(String title) {
return FirebaseFirestore.instance.collection('tasks').add({
'title': title,
'completed': false,
'createdAt': FieldValue.serverTimestamp(),
});
}
class TaskList extends StatefulWidget {
const TaskList({super.key});
@override
State<TaskList> createState() => _TaskListState();
}
class _TaskListState extends State<TaskList> {
// Create the stream once so that it isn't recreated on every rebuild.
final Stream<QuerySnapshot<Map<String, dynamic>>> _tasksStream =
FirebaseFirestore.instance
.collection('tasks')
.orderBy('createdAt', descending: true)
.snapshots();
@override
Widget build(BuildContext context) {
return StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
stream: _tasksStream,
builder: (context, snapshot) {
if (snapshot.hasError) {
return const Center(child: Text('Something went wrong.'));
}
if (snapshot.connectionState == ConnectionState.waiting) {
return const Center(child: CircularProgressIndicator());
}
final docs = snapshot.data!.docs;
return ListView.builder(
itemCount: docs.length,
itemBuilder: (context, index) {
final data = docs[index].data();
return ListTile(
title: Text(data['title'] as String? ?? ''),
);
},
);
},
);
}
}
離線持久化在 Android 與 Apple 平台上預設啟用(在網頁上可選擇啟用), 因此你的應用程式可以在沒有網路連線時讀取與寫入快取的文件, 並在連線恢復時自動同步變更。若要開始使用,請參考 Cloud Firestore quickstart。
使用 Firebase SQL Connect 查詢關聯式 SQL 資料
#
如果你的應用程式需要關聯式資料庫,Firebase SQL Connect
(前身為 Firebase Data Connect)提供託管的 PostgreSQL 資料庫,
並產生以 firebase_data_connect
套件為基礎的型別安全 Dart SDK。
若要安裝此插件,請執行:
flutter pub add firebase_data_connect
若要比較 SQL Connect、Cloud Firestore 與本機 SQLite,請參考 Choose a database for your Flutter app。若要設定 SQL Connect 後端並從 Flutter 呼叫它,請依照 use generated Flutter SDKs 的指南操作。
與無伺服器 Firebase 後端共用 Dart 程式碼
#
當你的應用程式需要自訂的伺服器端邏輯、背景觸發器,
或對 Firebase 服務的管理存取權時,你可以使用
firebase_functions
與 firebase_admin_sdk 套件,
撰寫 Cloud Functions for Firebase in Dart。
在 Flutter 前端與 Firebase 後端都使用 Dart, 讓你可以在用戶端與伺服器之間共用單一 Dart 套件, 包含資料模型、JSON 序列化與驗證規則。若要了解如何 建構共用套件的工作區,請參考 Sharing code between Flutter apps and Dart backends。
Flutter 與 Firebase 資源
#想進一步了解如何使用 Firebase 建置 Flutter 應用程式, 請參考以下官方與社群資源。
文件與 codelab
#- Add Firebase to your Flutter app
- Choose a database for your Flutter app
- Get to know Firebase for Flutter codelab
- Add a user authentication flow using FirebaseUI
- Firebase AI Logic documentation
- Use Firebase to host your Flutter app on the web
影片
#Unless stated otherwise, the documentation on this site reflects Flutter 3.47. Page last updated on 2026-10-25. View source or report an issue.