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

Firebase 即時資料庫是雲端託管的資料庫,資料會以 JSON 格式儲存 並即時同步至每個連結的用戶端建構應用程式 導入 Android、iOS 和 JavaScript SDK 的跨平台應用程式 用戶端會共用一個即時資料庫執行個體,並自動透過 最新資料

Firebase 即時資料庫支援 iOS 等所有 Apple 平台, macOS、macOS Catalyst、tvOS 和 watchOS。但 App Clips 不支援這項功能。 本頁的設定操作說明是以特定範例為參照 iOS, 適用於任何 Apple 平台目標。

事前準備

  1. 安裝 Firebase SDK
  2. Firebase 主控台中,將應用程式加入 Firebase 專案。

建立資料庫

  1. 前往數據分析的「Realtime Database」(即時資料庫) 部分。 Firebase 控制台: 系統會提示您選取現有的 Firebase 專案。 按照資料庫建立工作流程操作。

  2. 選取 Firebase 安全性規則的啟動模式:

    測試模式

    適合入門至行動和網路用戶端程式庫 但允許所有人讀取及覆寫您的資料測試完畢後, 請務必參閱「瞭解 Firebase 即時資料庫規則」 專區。

    如要開始使用網頁、Apple 或 Android SDK,請選取「testmode」。

    鎖定模式

    拒絕所有來自行動和網路用戶端的讀寫作業。 但經驗證的應用程式伺服器仍然可以存取您的資料庫。

  3. 選擇資料庫的位置。

    根據用途 資料庫的位置,也就是 新資料庫的網址格式如下:

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

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

  4. 點選「完成」

啟用即時資料庫後,系統也會啟用即時資料庫中的 API Cloud API Manager

將 Firebase 即時資料庫新增至應用程式

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

  1. 在 Xcode 中保持開啟應用程式專案,然後依序選擇 [檔案] >新增套件
  2. 在系統提示時,新增 Firebase Apple 平台 SDK 存放區:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. 選擇即時資料庫資料庫。
  5. 在目標建構設定的「Other Linker Flags」部分中新增 -ObjC 標記。
  6. 完成後,Xcode 會自動開始解析並下載 複製到背景依附元件

設定即時資料庫安全性規則

即時資料庫提供一種宣告規則語言, 定義資料結構、建立索引的方式 資料可供讀取及寫入

設定 Firebase 即時資料庫

您必須先初始化 Firebase,才能建立任何 Firebase 應用程式參照。 如果您已經為另一項 Firebase 功能執行這項作業,可以略過 這個步驟。

  1. FirebaseCore 模組匯入至 UIApplicationDelegate和任何其他 應用程式委派所用的 Firebase 模組。 例如,如要使用 Cloud Firestore 和驗證功能:

    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. 設定 FirebaseApp 共用執行個體 application(_:didFinishLaunchingWithOptions:) 方法:

    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,則必須建立並附加應用程式委派 透過 UIApplicationDelegateAdaptorApp NSApplicationDelegateAdaptor。您也必須停用應用程式委派功能切換功能。適用對象 詳情請參閱 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];

後續步驟