Cài đặt & Thiết lập trên các nền tảng của Apple

Firebase Realtime Database là một cơ sở dữ liệu được lưu trữ trên đám mây. Dữ liệu được lưu trữ dưới dạng JSON và được đồng bộ hoá theo thời gian thực với mọi ứng dụng đã kết nối. Khi bạn tạo ứng dụng đa nền tảng bằng SDK Android, iOS và JavaScript của chúng tôi, tất cả các ứng dụng khách của bạn sẽ dùng chung một thực thể Realtime Database và tự động nhận được các bản cập nhật bằng dữ liệu mới nhất.

Firebase Realtime Database có trên tất cả các nền tảng của Apple, bao gồm iOS, macOS, macOS Catalyst, tvOS và watchOS. Tính năng này không dùng được cho Đoạn ứng dụng. Hướng dẫn thiết lập trên trang này tham chiếu đến iOS trong các ví dụ cụ thể, nhưng là hướng dẫn chung và hoạt động cho mọi mục tiêu nền tảng của Apple.

Điều kiện tiên quyết

  1. Cài đặt Firebase SDK.
  2. Thêm ứng dụng của bạn vào dự án Firebase trong bảng điều khiển Firebase.

Tạo cơ sở dữ liệu

  1. Chuyển đến phần Realtime Database của bảng điều khiển Firebase. Bạn sẽ được nhắc chọn một dự án Firebase hiện có. Làm theo quy trình tạo cơ sở dữ liệu.

  2. Chọn chế độ khởi động cho Firebase Security Rules:

    Chế độ kiểm thử

    Phù hợp để bắt đầu với các thư viện ứng dụng di động và ứng dụng web, nhưng cho phép mọi người đọc và ghi đè dữ liệu của bạn. Sau khi kiểm thử, hãy nhớ xem lại phần Tìm hiểu về quy tắc của Cơ sở dữ liệu thời gian thực Firebase.

    Để bắt đầu với SDK web, Apple hoặc Android, hãy chọn testmode.

    Chế độ khoá

    Từ chối mọi hoạt động đọc và ghi từ ứng dụng di động và ứng dụng web. Các máy chủ ứng dụng đã xác thực vẫn có thể truy cập vào cơ sở dữ liệu của bạn.

  3. Chọn vị trí cho cơ sở dữ liệu.

    Tuỳ thuộc vào vị trí của cơ sở dữ liệu, URL cho cơ sở dữ liệu mới sẽ có một trong các dạng sau:

    • DATABASE_NAME.firebaseio.com (đối với cơ sở dữ liệu trong us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (đối với cơ sở dữ liệu ở tất cả các vị trí khác)

  4. Nhấp vào Xong.

Khi bạn bật Realtime Database, API này cũng sẽ được bật trong Trình quản lý API trên đám mây.

Thêm Firebase Realtime Database vào ứng dụng

Sử dụng Swift Package Manager để cài đặt và quản lý các phần phụ thuộc của Firebase.

  1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK Firebase cho các nền tảng của Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Chọn thư viện Realtime Database.
  5. Thêm cờ -ObjC vào mục Cờ trình liên kết khác trong chế độ cài đặt bản dựng của mục tiêu.
  6. Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc của bạn xuống ở chế độ nền.

Định cấu hình Realtime Database Security Rules

Realtime Database cung cấp một ngôn ngữ quy tắc khai báo cho phép bạn xác định cách dữ liệu của bạn nên được cấu trúc, cách dữ liệu nên được lập chỉ mục và thời điểm dữ liệu có thể được đọc và ghi.

Thiết lập Firebase Realtime Database

Bạn phải khởi động Firebase trước khi tạo hoặc sử dụng bất kỳ thông tin tham chiếu nào về ứng dụng Firebase. Nếu đã thực hiện việc này cho một tính năng khác của Firebase, bạn có thể bỏ qua bước này.

  1. Nhập mô-đun FirebaseCore trong UIApplicationDelegate, cũng như mọi mô-đun Firebase khác mà uỷ quyền ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud FirestoreAuthentication:

    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. Định cấu hình một phiên bản dùng chung FirebaseApp trong phương thức application(_:didFinishLaunchingWithOptions:) của uỷ quyền ứng dụng:

    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. Nếu đang sử dụng SwiftUI, bạn phải tạo một uỷ quyền ứng dụng và đính kèm uỷ quyền đó vào cấu trúc App thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor. Bạn cũng phải tắt tính năng thay thế phương thức uỷ quyền của ứng dụng. Để biết thêm thông tin, hãy xem hướng dẫn về 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. Tạo một thông tin tham chiếu đến cơ sở dữ liệu của bạn và chỉ định vị trí mà bạn muốn ghi vào.

    Swift

    Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Objective-C

    Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

Các bước tiếp theo