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 được kết nối. Khi tạo bản dựng đa nền tảng với Android, iOS và JavaScript SDK, tất cả ứng dụng khách chia sẻ một phiên bản Realtime Database và tự động nhận thông tin cập nhật với dữ liệu mới nhất.

Firebase Realtime Database có sẵn trên tất cả các nền tảng của Apple, bao gồm cả iOS, macOS, macOS Catalyst, tvOS và watchOS. Tính năng này không dùng được cho Ứng dụng thu nhỏ. Hướng dẫn thiết lập trong trang này tham khảo iOS trong các ví dụ cụ thể, nhưng chung và phù hợp với 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 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 Firebase bảng điều khiển. 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ế độ thử nghiệm

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

    Để bắt đầu sử dụng web, Apple hoặc SDK Android, hãy chọn chế độ thử nghiệm.

    Chế độ khoá

    Từ chối mọi lượt đọc và ghi từ ứng dụng di động và web. Máy chủ ứng dụng đã xác thực của bạn 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 (cho 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ẽ bật API 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 Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc Firebase.

  1. Trong Xcode, khi dự án ứng dụng đ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 nền tảng Apple của Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Chọn thư viện Realtime Database.
  5. Thêm cờ -ObjC vào phần Other Linker Flags (Cờ trình liên kết khác) trong phần 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 xuống các phần phụ thuộc trong nền.

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

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

Thiết lập Firebase Realtime Database

Bạn phải khởi chạy Firebase trước khi tạo bất kỳ tham chiếu ứng dụng Firebase nào hoặc đã sử dụng. 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ư bất kỳ tên nào khác Các mô-đun Firebase mà người được uỷ quyề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 FirebaseApp thực thể dùng chung trong Phương thức application(_:didFinishLaunchingWithOptions:):

    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 ứng dụng uỷ quyền và đính kèm nó đến cấu trúc App của bạn thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor. Bạn cũng phải tắt tính năng hoán đổi ứng dụng uỷ quyền. Để hãy xem hướng dẫn về SwiftUI để biết thêm thông tin.

    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 tệp tham chiếu đến cơ sở dữ liệu và chỉ định vị trí bạn muốn ghi.

    Swift

    Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Objective-C

    Lưu ý: Sản phẩm Firebase này không dùng được cho mục tiêu Đoạn video ngắn.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

Các bước tiếp theo