Firebase Realtime Database 是雲端代管資料庫。資料會以 JSON 格式儲存,並即時同步處理至每個已連結的用戶端。使用 Android、iOS 和 JavaScript SDK 建構跨平台應用程式時,所有用戶端都會共用一個 Realtime Database 例項,並自動接收含最新資料的更新。
Firebase Realtime Database 適用於所有 Apple 平台,包括 iOS、macOS、macOS Catalyst、tvOS 和 watchOS。不適用於 App Clip。本頁的設定說明會在特定範例中參照 iOS,但這些說明是通用的,可用於任何 Apple 平台目標。
事前準備
- 安裝 Firebase SDK。
- 在 Firebase 主控台中,將應用程式新增至 Firebase 專案。
建立資料庫
前往 Firebase 控制台的 Realtime Database 專區。系統會提示您選取現有的 Firebase 專案。按照資料庫建立工作流程操作。
為 Firebase Security Rules 選取起始模式:
- 測試模式
適合開始使用行動和網路用戶端程式庫,但允許任何人讀取及覆寫您的資料。測試完成後,請務必詳閱「瞭解 Firebase 即時資料庫規則」一節。
如要開始使用網路、Apple 或 Android SDK,請選取 testmode。
- 鎖定模式
拒絕行動和網路用戶端的所有讀寫要求。已驗證的應用程式伺服器仍可存取資料庫。
選擇資料庫的位置。
視資料庫的位置而定,新資料庫的網址會採用下列任一形式:
(適用於DATABASE_NAME.firebaseio.com
us-central1
中的資料庫) (適用於所有其他位置的資料庫)DATABASE_NAME.REGION.firebasedatabase.app
按一下「完成」。
啟用 Realtime Database 時,也會在 Cloud API Manager 中啟用 API。
在應用程式中新增 Firebase Realtime Database
使用 Swift Package Manager 安裝及管理 Firebase 依附元件。
- 在 Xcode 中保持開啟應用程式專案,然後依序點選「File」>「Add Packages」。
- 系統提示時,請新增 Firebase Apple 平台 SDK 存放區:
- 選擇 Realtime Database 程式庫。
- 將
-ObjC
標記新增至目標的建構設定「Other Linker Flags」部分。 - 完成後,Xcode 就會自動開始在背景中解析並下載依附元件。
https://github.com/firebase/firebase-ios-sdk.git
設定「Realtime Database Security Rules」
Realtime Database 提供宣告式規則語言,可讓您定義資料的結構、索引方式,以及資料可讀取及寫入的時機。
設定「Firebase Realtime Database」
您必須先初始化 Firebase,才能建立或使用任何 Firebase 應用程式參照。如果您已為其他 Firebase 功能完成這項操作,可以略過這個步驟。
- 在
UIApplicationDelegate
中匯入FirebaseCore
模組,以及應用程式委派程式使用的任何其他 Firebase 模組。例如,如要使用 Cloud Firestore 和 Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 在應用程式委派作業的
application(_:didFinishLaunchingWithOptions:)
方法中,設定FirebaseApp
共用例項:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- 如果您使用 SwiftUI,則必須建立應用程式委派程式,並透過
UIApplicationDelegateAdaptor
或NSApplicationDelegateAdaptor
將其附加至App
結構體。您也必須停用應用程式委派程式 swizzling。詳情請參閱 SwiftUI 操作說明。SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- 建立資料庫參照,並指定要寫入的位置。
Swift
注意:這項 Firebase 產品不適用於 App Clip 目標。var ref: DatabaseReference! ref = Database.database().reference()
Objective-C
注意:這項 Firebase 產品不適用於 App Clip 目標。@property (strong, nonatomic) FIRDatabaseReference *ref; self.ref = [[FIRDatabase database] reference];
後續步驟
準備發布應用程式:
啟用 App Check,確保只有您的應用程式可以存取資料庫。
在 Google Cloud 控制台中為專案設定預算快訊。
請在 Firebase 控制台中監控使用量和帳單資訊主頁,全面掌握專案在多項 Firebase 服務中的用量。您也可以前往 Realtime Database「用量」資訊主頁,查看更詳細的用量資訊。
詳閱 Firebase 上市檢查清單。