เพิ่ม Firebase ลงในโปรเจ็กต์ Apple

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

  • ติดตั้งสิ่งต่อไปนี้

    • Xcode 26.2 ขึ้นไป

  • ตรวจสอบว่าโปรเจ็กต์เป็นไปตามข้อกำหนดต่อไปนี้

    • โปรเจ็กต์ต้องกำหนดเป้าหมายเป็นแพลตฟอร์มเวอร์ชันต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
      • iOS 15
      • macOS 10.15
      • tvOS 15
      • watchOS 7

  • ตั้งค่าอุปกรณ์ Apple จริงหรือใช้เครื่องจำลองเพื่อเรียกใช้แอป

หากยังไม่มีโปรเจ็กต์ Xcode และเพียงต้องการลองใช้ผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดตัวอย่างการเริ่มต้นอย่างรวดเร็วของเรา

ขั้นตอนที่ 1: สร้างโปรเจ็กต์ Firebase

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

ขั้นตอนที่ 2: ลงทะเบียนแอปกับ Firebase

หากต้องการใช้ Firebase ในแอป Apple คุณต้องลงทะเบียนแอปกับโปรเจ็กต์ Firebase การลงทะเบียนแอปมักเรียกว่า "การเพิ่ม" แอปไปยังโปรเจ็กต์

  1. ไปที่Firebase Console

  2. ที่กึ่งกลางหน้าภาพรวมโปรเจ็กต์ ให้คลิกไอคอน iOS+ เพื่อเปิดเวิร์กโฟลว์การตั้งค่า

    หากเพิ่มแอปไปยังโปรเจ็กต์ Firebase แล้ว ให้คลิกเพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม

  3. ป้อนรหัสชุดของแอปในช่องรหัสชุด

  4. (ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ ดังนี้ ชื่อเล่นของแอปและรหัส App Store

  5. คลิกลงทะเบียนแอป

ขั้นตอนที่ 3: เพิ่มไฟล์กำหนดค่า Firebase

  1. คลิกดาวน์โหลด GoogleService-Info.plist เพื่อรับ ไฟล์กำหนดค่า Firebase (GoogleService-Info.plist) ของแอป

  2. ย้ายไฟล์การกำหนดค่าไปยังรูทของโปรเจ็กต์ Xcode หากได้รับข้อความแจ้ง ให้เลือกเพิ่มไฟล์กำหนดค่าไปยังเป้าหมายทั้งหมด

หากมี Bundle ID หลายรายการในโปรเจ็กต์ คุณต้องเชื่อมโยง Bundle ID แต่ละรายการกับแอปที่ลงทะเบียนไว้ในFirebase Console เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist ของตัวเองได้

ขั้นตอนที่ 4: เพิ่ม Firebase SDK ลงในแอป

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

  1. ใน Xcode เมื่อเปิดโปรเจ็กต์แอปแล้ว ให้ไปที่ไฟล์ > เพิ่มแพ็กเกจ
  2. เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ Firebase Apple Platforms SDK ดังนี้
    3.   https://github.com/firebase/firebase-ios-sdk
  3. เลือกเวอร์ชัน SDK ที่ต้องการใช้

  4. เลือกไลบรารี Firebase ที่ต้องการใช้

    หากเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase ให้ตรวจสอบว่า ได้เพิ่ม FirebaseAnalytics แล้ว ซึ่งจะให้ฟีเจอร์การวิเคราะห์ทั้งหมด นอกจากนี้ คุณยังเลือกฟีเจอร์แต่ละรายการได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่คำถามที่พบบ่อยเกี่ยวกับการจัดระเบียบโมดูลล่าสุดใน Google Analytics สำหรับ Firebase SDK

เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการขึ้นต่อกันในเบื้องหลังโดยอัตโนมัติ

ขั้นตอนที่ 5: เริ่มต้น Firebase ในแอป

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

  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 นอกจากนี้ คุณยังต้องปิดใช้การสลับแทนของตัวแทนแอปด้วย ดูข้อมูลเพิ่มเติมได้ที่วิธีการสำหรับ 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. หากคุณได้รวม Firebase SDK สำหรับ Google Analytics ไว้แล้ว คุณสามารถเรียกใช้ แอปเพื่อส่งการยืนยันไปยังคอนโซล Firebase ว่าคุณได้ ติดตั้ง Firebase เรียบร้อยแล้ว

เพียงเท่านี้ก็เสร็จแล้ว! คุณข้ามไปที่ขั้นตอนถัดไปได้

หากพบปัญหาในการตั้งค่า โปรดไปที่การแก้ปัญหาและคำถามที่พบบ่อยเกี่ยวกับแพลตฟอร์มของ Apple

ไลบรารีที่ใช้ได้

ส่วนนี้แสดงผลิตภัณฑ์ Firebase ที่รองรับแพลตฟอร์ม Apple ดูข้อมูลเพิ่มเติมเกี่ยวกับไลบรารีแพลตฟอร์ม Apple ของ Firebase เหล่านี้

บริการหรือผลิตภัณฑ์ ชื่อไลบรารี / เฟรมเวิร์ก เพิ่ม Analytics ไหม
AdMob GoogleMobileAds
Firebase AI Logic 1
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (ต้องระบุ)
Firebase การติดตั้ง FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
ไลบรารีที่เลิกใช้งานแล้วหรือไม่รองรับ
Dynamic Links FirebaseDynamicLinks
Firebase ML API โมเดลที่กำหนดเอง FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) เดิมชื่อ "Vertex AI ใน Firebase" และจัดจำหน่ายภายใต้โมดูล FirebaseVertexAI Firebase AI Logic เคยจัดจำหน่ายภายใต้โมดูล FirebaseAI ด้วย

2 Firebase SQL Connect เดิมชื่อ "Firebase Data Connect"

ผสานรวมโดยไม่ใช้ Swift Package Manager

หากไม่ต้องการใช้ Swift Package Manager คุณยังคงผสานรวม Firebase ได้ โดยการนำเข้าเฟรมเวิร์กที่คอมไพล์ล่วงหน้าโดยตรง

เฟรมเวิร์ก

นอกจากจะรองรับแพลตฟอร์ม iOS แล้ว ตอนนี้ไฟล์ ZIP ยังมีไฟล์ .xcframework ด้วย ดูรายละเอียดได้ที่ README ของ Firebase Apple Platforms SDK ใน GitHub

  1. ดาวน์โหลด framework SDK zip ไฟล์นี้มีขนาดประมาณ 200 MB และอาจใช้เวลา สักครู่ในการดาวน์โหลด

  2. แตกไฟล์ แล้วผสานรวมเฟรมเวิร์กที่ต้องการรวมไว้ในแอป

    คุณดูวิธีการผสานรวมได้จากที่ใดที่หนึ่งต่อไปนี้

    ดูข้อมูลเกี่ยวกับเวอร์ชันของเฟรมเวิร์กหรือการอ้างอิงได้ในไฟล์ METADATA.md ภายในไฟล์ ZIP ที่ดาวน์โหลดมา

  3. เพิ่ม -ObjC แฟล็ก Linker ใน Other Linker Flags ในการตั้งค่าบิลด์ของเป้าหมาย

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

ดูข้อมูลเกี่ยวกับ Firebase

เพิ่มบริการ Firebase ไปยังแอป

  • สร้างฟีเจอร์ Generative AI ด้วยโมเดล Gemini โดยใช้ Firebase AI Logic

  • รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย Analytics

  • ตั้งค่าการตรวจสอบสิทธิ์ของผู้ใช้ด้วย Authentication

  • จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย Cloud Firestore หรือ Realtime Database

  • จัดเก็บไฟล์ เช่น รูปภาพและวิดีโอ ด้วย Cloud Storage

  • ทริกเกอร์โค้ดแบ็กเอนด์ที่ทำงานในสภาพแวดล้อมที่ปลอดภัยด้วย Cloud Functions

  • ส่งการแจ้งเตือนด้วย Cloud Messaging

  • ดูว่าแอปขัดข้องเมื่อใดและเพราะเหตุใดด้วย Crashlytics