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

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

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

ข้อกำหนดเบื้องต้น

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

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

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

2. เลือกโหมดเริ่มต้นสำหรับ Firebase Security Rules

   โหมดทดสอบ

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

   หมายเหตุ: หากคุณสร้างฐานข้อมูลในโหมดทดสอบและไม่ได้เปลี่ยนแปลงRulesที่อ่านและเขียนได้แบบทุกคนโดยค่าเริ่มต้นภายในระยะเวลาทดลองใช้ ระบบจะส่งการแจ้งเตือนทางอีเมล จากนั้นกฎฐานข้อมูลจะปฏิเสธคำขอทั้งหมด จดวันที่หมดอายุไว้ในระหว่าง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 Realtime Database ลงในแอป

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

ไปที่คู่มือการติดตั้งเพื่อดูวิธีต่างๆ ในการเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Apple ซึ่งรวมถึงการนําเข้าเฟรมเวิร์กโดยตรงและการใช้ CocoaPods

1. เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ไฟล์ > เพิ่มแพ็กเกจ
2. เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ Firebase SDK สําหรับแพลตฟอร์ม Apple ดังนี้

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

หมายเหตุ: โปรเจ็กต์ใหม่ควรใช้ SDK เวอร์ชันเริ่มต้น (ล่าสุด) แต่คุณจะเลือกเวอร์ชันเก่าก็ได้หากจำเป็น
3. เลือกคลัง Realtime Database
4. เพิ่ม Flag -ObjC ลงในส่วน Other Linker Flags ของการตั้งค่าบิลด์เป้าหมาย
5. เมื่อเสร็จแล้ว Xcode จะเริ่มจับคู่ข้อมูลและดาวน์โหลดทรัพยากร Dependency ในเบื้องหลังโดยอัตโนมัติ

กำหนดค่า Realtime Database Security Rules

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

หมายเหตุ: โดยค่าเริ่มต้น ระบบจะจํากัดการเข้าถึงฐานข้อมูลแบบอ่านและเขียนเพื่อให้มีเพียงผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์เท่านั้นที่อ่านหรือเขียนข้อมูลได้ หากต้องการเริ่มต้นใช้งานโดยไม่ต้องตั้งค่า Authentication ให้กำหนดค่ากฎสำหรับการเข้าถึงแบบสาธารณะ ซึ่งจะทำให้ฐานข้อมูลเปิดอยู่สำหรับทุกคน รวมถึงผู้ที่ไม่ได้ใช้แอปของคุณ ดังนั้นโปรดจำกัดฐานข้อมูลอีกครั้งเมื่อตั้งค่าการตรวจสอบสิทธิ์

ตั้งค่า 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 คุณต้องสร้างผู้รับมอบสิทธิ์แอปพลิเคชันและแนบไปกับ App struct ผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor นอกจากนี้ คุณยังต้องปิดใช้การสลับผู้รับมอบสิทธิ์แอปด้วย ดูข้อมูลเพิ่มเติมได้ที่วิธีการ 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. สร้างการอ้างอิงไปยังฐานข้อมูลและระบุตำแหน่งที่ต้องการเขียน
   สำคัญ: หากต้องการอ้างอิงฐานข้อมูลอื่นนอกเหนือจากฐานข้อมูลเริ่มต้น us-central1 คุณต้องส่ง URL ของฐานข้อมูลไปยัง database() (หรือ databaseWithURL สำหรับ Objective-C) สำหรับฐานข้อมูลเริ่มต้น us-central1 คุณสามารถเรียกใช้ database() (หรือ database) โดยไม่ต้องใช้อาร์กิวเมนต์

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

   • https://DATABASE_NAME.firebaseio.com (สําหรับฐานข้อมูลใน us-central1)
   • https://DATABASE_NAME.REGION.firebasedatabase.app (สําหรับฐานข้อมูลในทุกตำแหน่งอื่นๆ)

   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