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

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

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

    • Xcode 26.2 ขึ้นไป

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

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

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

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

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

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

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

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

  1. ไปที่คอนโซล Firebase

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate รวมถึงโมดูล Firebase อื่นๆ ที่ App Delegate ของคุณใช้ ตัวอย่างเช่น หากต้องการใช้ 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:) ของ App Delegate ดังนี้

    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
API โมเดลที่กำหนดเองของ Firebase ML 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. แตกไฟล์ แล้วผสานรวมเฟรมเวิร์กที่ต้องการรวมไว้ในแอป

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

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

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

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

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

เพิ่มบริการ Firebase ลงในแอป

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

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

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

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

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

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

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

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