安裝及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
  4. 選擇實時數據庫庫。
  5. 完成後,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];

下一步