安裝(&A)在 Apple 平台上進行設定

Firebase Realtime Database 是雲端代管資料庫。資料會以 JSON 格式儲存，並即時同步處理至每個已連結的用戶端。使用 Android、iOS 和 JavaScript SDK 建構跨平台應用程式時，所有用戶端都會共用一個 Realtime Database 例項，並自動接收含最新資料的更新。

Firebase Realtime Database 適用於所有 Apple 平台，包括 iOS、macOS、macOS Catalyst、tvOS 和 watchOS。不適用於 App Clip。本頁的設定說明會在特定範例中參照 iOS，但這些說明是通用的，可用於任何 Apple 平台目標。

事前準備

  1. 安裝 Firebase SDK。
  2. 在 Firebase 主控台中，將應用程式新增至 Firebase 專案。

建立資料庫

  1. 前往 Firebase 控制台的 Realtime Database 專區。系統會提示您選取現有的 Firebase 專案。按照資料庫建立工作流程操作。

  2. 為 Firebase Security Rules 選取起始模式：

    測試模式

    適合開始使用行動和網路用戶端程式庫，但允許任何人讀取及覆寫您的資料。測試完成後，請務必詳閱「瞭解 Firebase 即時資料庫規則」一節。

    如要開始使用網路、Apple 或 Android SDK，請選取 testmode。

    鎖定模式

    拒絕行動和網路用戶端的所有讀寫要求。已驗證的應用程式伺服器仍可存取資料庫。

  3. 選擇資料庫的位置。

    視資料庫的位置而定，新資料庫的網址會採用下列任一形式：

    • DATABASE_NAME.firebaseio.com (適用於 us-central1 中的資料庫)

    • DATABASE_NAME.REGION.firebasedatabase.app (適用於所有其他位置的資料庫)

  4. 點選「完成」。

啟用 Realtime Database 時，也會在 Cloud API Manager 中啟用 API。

在應用程式中新增 Firebase Realtime Database

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

  1. 在 Xcode 中保持開啟應用程式專案，然後依序點選「File」>「Add Packages」。
  2. 系統提示時，請新增 Firebase Apple 平台 SDK 存放區：
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. 選擇 Realtime Database 程式庫。
  4. 將 -ObjC 標記新增至目標的建構設定「Other Linker Flags」部分。
  5. 完成後，Xcode 就會自動開始在背景中解析並下載依附元件。

設定「Realtime Database Security Rules」

Realtime Database 提供宣告式規則語言，可讓您定義資料的結構、索引方式，以及資料可讀取及寫入的時機。

設定「Firebase Realtime Database」

您必須先初始化 Firebase，才能建立或使用任何 Firebase 應用程式參照。如果您已為其他 Firebase 功能完成這項操作，可以略過這個步驟。

  1. 在 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;
// ...
  2. 在應用程式委派作業的 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];
  3. 如果您使用 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()
      }
    }
  }
}
  4. 建立資料庫參照，並指定要寫入的位置。

    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];

後續步驟