安裝及Apple 平台上的設置

Firebase 即時資料庫是一個雲端託管資料庫。資料以 JSON 形式儲存並即時同步到每個連接的客戶端。當您使用我們的 Android、iOS 和 JavaScript SDK 建立跨平台應用程式時,您的所有用戶端都會共用一個即時資料庫實例,並自動接收最新資料的更新。

Firebase 即時資料庫可在所有 Apple 平台上使用,包括 iOS、macOS、macOS Catalyst、tvOS 和 watchOS。它不適用於應用剪輯。本頁中的設定說明在特定範例中引用了 iOS,但它們是通用的,適用於任何 Apple 平台目標。

先決條件

  1. 安裝 Firebase SDK
  2. 將您的應用程式新增至Firebase 控制台中的 Firebase 專案。

建立資料庫

  1. 導覽至Firebase 控制台「即時資料庫」部分。系統會提示您選擇現有的 Firebase 專案。遵循資料庫建立工作流程。

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

    測試模式

    適合開始使用行動和 Web 用戶端庫,但允許任何人讀取和覆蓋您的資料。測試後,請務必查看了解 Firebase 即時資料庫規則部分。

    若要開始使用 Web、Apple 或 Android SDK,請選擇測試模式。

    鎖定模式

    拒絕來自行動和 Web 用戶端的所有讀取和寫入。經過身份驗證的應用程式伺服器仍然可以存取您的資料庫。

  3. 選擇資料庫的位置。

    根據資料庫的位置,新資料庫的 URL 將採用以下形式之一:

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

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

  4. 按一下“完成”

啟用即時資料庫時,也會啟用Cloud API Manager中的 API。

將 Firebase 即時資料庫新增至您的應用

使用 Swift Package Manager 安裝和管理 Firebase 相依性。

  1. 在 Xcode 中,開啟應用程式項目,導覽至File > Add Packages
  2. 出現提示時,新增 Firebase Apple 平台 SDK 儲存庫:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. 選擇即時資料庫庫。
  5. -ObjC標誌新增至目標建置設定的「其他連結器標誌」部分。
  6. 完成後,Xcode 將自動開始在背景解析並下載您的依賴項。

配置即時資料庫安全規則

即時資料庫提供了一種聲明性規則語言,可讓您定義資料的結構方式、索引的方式以及何時可以讀取和寫入資料。

設定 Firebase 即時資料庫

您必須在建立或使用任何 Firebase 應用程式引用之前初始化 Firebase。如果您已對其他 Firebase 功能執行此操作,則可以跳過此步驟。

  1. UIApplicationDelegate中導入FirebaseCore模組,以及應用程式委託使用的任何其他Firebase 模組。例如,要使用 Cloud Firestore 和身份驗證:

    斯威夫特使用者介面

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    迅速

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 在應用程式委託的application(_:didFinishLaunchingWithOptions:)方法中設定FirebaseApp共享實例:

    斯威夫特使用者介面

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    迅速

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 如果您使用 SwiftUI,則必須建立應用程式委託並透過UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor將其附加到您的App結構。您還必須停用應用程式委託調配。有關更多信息,請參閱SwiftUI 說明

    斯威夫特使用者介面

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. 建立對資料庫的引用並指定要寫入的位置。

    迅速

    注意:此 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];

下一步