安裝(&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
  4. 選擇 Realtime Database 程式庫。
  5. -ObjC 標記新增至目標的建構設定「Other Linker Flags」部分。
  6. 完成後,Xcode 就會自動開始在背景中解析並下載依附元件。

設定「Realtime Database Security Rules

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

設定「Firebase Realtime Database

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

  1. UIApplicationDelegate 中匯入 FirebaseCore 模組,以及應用程式委派程式使用的任何其他 Firebase 模組。例如,如要使用 Cloud FirestoreAuthentication

    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,則必須建立應用程式委派程式,並透過 UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor 將其附加至 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];

後續步驟