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

Firebase Realtime Database 是雲端代管的資料庫。資料會以 JSON 格式儲存，並即時同步至每個連線的用戶端。使用 Android、iOS 和 JavaScript SDK 建構跨平台應用程式時，所有用戶端都會共用一個 Realtime Database 執行個體，並自動接收最新資料的更新。

Firebase Realtime Database 適用於所有 Apple 平台，包括 iOS、macOS、macOS Catalyst、tvOS 和 watchOS。不適用於 App Clips。 本頁的設定說明在特定範例中會提及 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 管理工具中啟用 API。

在應用程式中新增 Firebase Realtime Database

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

1. 在 Xcode 中保持開啟應用程式專案，然後依序點選「File」(檔案) 和「Add Packages」(新增 Package)。
2. 系統提示時，請新增 Firebase Apple 平台 SDK 存放區：

  https://github.com/firebase/firebase-ios-sdk.git

3. 選擇 Realtime Database 程式庫。
4. 將 -ObjC 標記新增至目標建構設定的「Other Linker Flags」部分。
5. 完成後，Xcode 會自動開始在背景中解析並下載依附元件。

設定 Realtime Database Security Rules

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

設定「Firebase Realtime Database」

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

1. 在 FirebaseCore 中匯入 UIApplicationDelegate 模組，以及應用程式委派使用的任何其他 Firebase 模組。舉例來說，如要使用 Cloud Firestore 和 Authentication：

   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，就必須建立應用程式委派，並透過 UIApplicationDelegateAdaptor 或 NSApplicationDelegateAdaptor 將其附加至 App 結構體。您也必須停用應用程式委派項目的交換。詳情請參閱 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];

後續步驟

• 瞭解如何為 Realtime Database 建構資料。

• 在多個資料庫執行個體中擴充資料。

• 讀取及寫入資料。

• 在 Firebase 控制台中查看資料庫。

• 準備發布應用程式：

  • 啟用 App Check，確保只有您的應用程式可以存取資料庫。

  • 在 Google Cloud 控制台中，為專案設定預算快訊。

  • 在 Firebase 控制台中監控「用量和帳單」資訊主頁，全面掌握專案在多項 Firebase 服務中的用量。如需更詳細的使用資訊，請前往Realtime Database「用量」資訊主頁。

  • 詳閱 Firebase 發布檢查清單。