การติดตั้งและการตั้งค่าในแพลตฟอร์ม Apple

ฐานข้อมูลเรียลไทม์ของ Firebase เป็นฐานข้อมูลที่โฮสต์บนระบบคลาวด์ ข้อมูลจะจัดเก็บเป็น JSON และซิงค์ข้อมูลกับไคลเอ็นต์ที่เชื่อมต่อทั้งหมดแบบเรียลไทม์ เมื่อคุณสร้างแอปข้ามแพลตฟอร์มด้วย SDK สำหรับ Android, iOS และ JavaScript ลูกค้าทุกรายจะแชร์อินสแตนซ์ Realtime Database รายการเดียวและได้รับการอัปเดตข้อมูลใหม่ล่าสุดโดยอัตโนมัติ

ฐานข้อมูลเรียลไทม์ของ Firebase พร้อมใช้งานในทุกแพลตฟอร์มของ Apple ได้แก่ iOS, macOS, macOS Catalyst, tvOS และ watchOS และจะใช้กับ App Clips ไม่ได้ วิธีการตั้งค่าในหน้านี้อ้างอิง iOS ในตัวอย่างที่เจาะจง แต่เป็นแบบทั่วไปและใช้ได้กับเป้าหมายแพลตฟอร์ม Apple ทั้งหมด

สิ่งที่ต้องดำเนินการก่อน

  1. ติดตั้ง Firebase SDK
  2. เพิ่มแอปลงในโปรเจ็กต์ Firebase ในคอนโซล Firebase

สร้างฐานข้อมูล

  1. ไปที่ส่วน Realtime Database ของคอนโซล Firebase ระบบจะแจ้งให้คุณเลือกโปรเจ็กต์ Firebase ที่มีอยู่ ทำตามขั้นตอนการสร้างฐานข้อมูล

  2. เลือกโหมดเริ่มต้นสำหรับกฎความปลอดภัยของ Firebase

    โหมดทดสอบ

    เหมาะสำหรับการเริ่มต้นใช้งานไลบรารีของไคลเอ็นต์อุปกรณ์เคลื่อนที่และเว็บ แต่อนุญาตให้ทุกคนอ่านและเขียนทับข้อมูลของคุณได้ หลังการทดสอบ อย่าลืมอ่านส่วนทำความเข้าใจกฎฐานข้อมูลเรียลไทม์ของ Firebase

    หากต้องการเริ่มต้นใช้งาน SDK บนเว็บ, Apple หรือ Android ให้เลือก testmode

    โหมดล็อกขณะคุมสอบ

    ปฏิเสธการอ่านและเขียนทั้งหมดจากไคลเอ็นต์อุปกรณ์เคลื่อนที่และเว็บ แอปพลิเคชันเซิร์ฟเวอร์ที่มีการตรวจสอบสิทธิ์ของคุณจะยังคงเข้าถึงฐานข้อมูลของคุณได้

  3. เลือกตำแหน่งสำหรับฐานข้อมูล

    URL สำหรับฐานข้อมูลใหม่จะอยู่ในรูปแบบใดรูปแบบหนึ่งต่อไปนี้ ทั้งนี้ขึ้นอยู่กับตำแหน่งของฐานข้อมูล

    • DATABASE_NAME.firebaseio.com (สำหรับ ฐานข้อมูลใน us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (สำหรับฐานข้อมูลในตำแหน่งอื่นๆ ทั้งหมด)

  4. คลิกเสร็จ

เมื่อคุณเปิดใช้ Realtime Database จะเป็นการเปิดใช้ API ใน Cloud API Manager ด้วย

เพิ่มฐานข้อมูลเรียลไทม์ของ Firebase ลงในแอป

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase

  1. เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ไฟล์ > เพิ่มแพ็กเกจ
  2. เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK สำหรับแพลตฟอร์ม Firebase ของ Apple ดังนี้
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. เลือกไลบรารี Realtime Database
  5. เพิ่มแฟล็ก -ObjC ลงในส่วนแฟล็ก Linker อื่นๆ ของการตั้งค่าบิลด์ของเป้าหมาย
  6. เมื่อเสร็จสิ้นแล้ว Xcode จะเริ่มแก้ปัญหาและดาวน์โหลดทรัพยากร Dependency ในเบื้องหลังโดยอัตโนมัติ

กำหนดค่ากฎความปลอดภัยของฐานข้อมูลเรียลไทม์

ฐานข้อมูลเรียลไทม์มีภาษาของกฎเชิงประกาศที่ช่วยให้คุณกำหนดโครงสร้างข้อมูล วิธีที่ควรจัดทำดัชนี และเวลาที่สามารถอ่านและเขียนข้อมูลได้

ตั้งค่าฐานข้อมูลเรียลไทม์ของ Firebase

คุณต้องเริ่มต้น 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. กำหนดค่าอินสแตนซ์ที่แชร์ของ FirebaseApp ในเมธอด 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. หากใช้ SwiftUI คุณต้องสร้างการมอบสิทธิ์แอปพลิเคชันและแนบการมอบสิทธิ์กับโครงสร้าง App ผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้ SWizzing ที่มอบสิทธิ์ของแอปด้วย ดูข้อมูลเพิ่มเติมได้ที่วิธีการของ 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];

ขั้นตอนถัดไป