安裝及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
  3. 選擇即時資料庫庫。
  4. 將-ObjC標誌新增至目標建置設定的「其他連結器標誌」部分。
  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，則必須建立應用程式委託並透過UIApplicationDelegateAdaptor或NSApplicationDelegateAdaptor將其附加到您的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];

下一步