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

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

  • ติดตั้งรายการต่อไปนี้

    • Xcode 15.2 ขึ้นไป

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

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

  • ตั้งค่าอุปกรณ์ Apple ที่จับต้องได้หรือใช้เครื่องจำลองในการเรียกใช้แอป

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

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

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

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

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

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

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

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

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

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

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

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

  1. คลิกดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์การกําหนดค่าแพลตฟอร์ม Apple ของ 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 สำหรับ Analytics ที่ไม่สามารถรวบรวม IDFA ได้ ให้เพิ่ม FirebaseAnalyticsWithoutAdId แทน

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

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

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

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

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

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

บริการหรือผลิตภัณฑ์ พ็อด คลัง SwiftPM Google Analytics">เพิ่ม Analytics
AdMob pod 'Google-Mobile-Ads-SDK' ไม่มี
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(ต้องระบุ)
การติดตั้ง Firebase ครั้ง pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Custom Model API pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI in Firebase pod 'FirebaseVertexAI' FirebaseVertexAI

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

หากไม่ต้องการใช้ Swift Package Manager คุณยังคงใช้ประโยชน์จาก Firebase SDK ได้โดยใช้ CocoaPods หรือนําเข้าเฟรมเวิร์กโดยตรง

CocoaPods

ดูข้อมูลเพิ่มเติมเกี่ยวกับการผสานรวม CocoaPods ในคู่มือของเรา

เฟรมเวิร์ก

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

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

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

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

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

  3. เพิ่ม-ObjC Flag ของ linker ใน Other Linker Settings ในการตั้งค่าการสร้างของเป้าหมาย

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

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

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

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

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

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

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

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

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

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