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

Cơ sở dữ liệu thời gian thực Firebase là 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ộ hóa theo thời gian thực với mọi máy khách được kết nối. Khi bạn xây dựng các ứng dụng đa nền tảng bằng SDK Android, iOS và JavaScript của chúng tôi, tất cả khách hàng của bạn sẽ chia sẻ một phiên bản Cơ sở dữ liệu thời gian thực và tự động nhận các bản cập nhật với dữ liệu mới nhất.

Cơ sở dữ liệu thời gian thực Firebase có sẵn trên tất cả các nền tảng của Apple, bao gồm iOS, macOS, macOS Catalyst, tvOS và watchOS. Nó không có sẵn cho Clip ứng dụng. 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 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 SDK Firebase .
  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. Điều hướng đến phần Cơ sở dữ liệu thời gian thực của bảng điều khiển Firebase . Bạn sẽ được nhắc chọn dự án Firebase hiện có. Thực hiện theo quy trình tạo cơ sở dữ liệu.

  2. Chọn chế độ bắt đầu cho Quy tắc bảo mật Firebase của bạn:

    Chê độ kiểm tra

    Phù hợp để bắt đầu với thư viện máy khách web và thiết bị 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 nhớ xem lại phần Tìm hiểu quy tắc cơ sở dữ liệu thời gian thực Firebase .

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

    Chế độ khóa

    Từ chối tất cả các hoạt động đọc và ghi từ máy khách trên thiết bị di động và web. Máy chủ ứng dụng đã được xác thực của bạn vẫn có thể truy cập cơ sở dữ liệu của bạn.

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

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

    • DATABASE_NAME .firebaseio.com (dành cho cơ sở dữ liệu trong us-central1 )

    • DATABASE_NAME . REGION .firebasedatabase.app (dành cho 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 Cơ sở dữ liệu thời gian thực, nó cũng kích hoạt API trong Trình quản lý API đám mây .

Thêm cơ sở dữ liệu thời gian thực Firebase vào ứng dụng của bạn

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 của Firebase.

  1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy điều hướng đến File > Add Packages .
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Firebase của Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Chọn thư viện Cơ sở dữ liệu thời gian thực.
  5. Thêm cờ -ObjC vào phần Cờ liên kết khác trong cài đặt bản dựng của mục tiêu của bạn.
  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 của bạn ở chế độ nền.

Định cấu hình quy tắc bảo mật cơ sở dữ liệu thời gian thực

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

Thiết lập cơ sở dữ liệu thời gian thực Firebase

Bạn phải khởi tạo Firebase trước khi tạo hoặc sử dụng bất kỳ tham chiếu ứng dụng Firebase nào. Nếu bạn đã 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ủa bạn, cũng như bất kỳ mô-đun Firebase nào khác mà ủy quyền ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và Xác thực:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Nhanh

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Mục tiêu-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Định cấu hình phiên bản chia sẻ FirebaseApp trong phương thức application(_:didFinishLaunchingWithOptions:) của đại biểu ứng dụng của bạn:

    SwiftUI

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Nhanh

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Mục tiêu-C

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

    Nhanh

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

    Mục tiêu-C

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

Bước tiếp theo