เพิ่ม Firebase ไปยังโปรเจ็กต์ Apple

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

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

    • Xcode 14.1 ขึ้นไป

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

    • โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
      • iOS 11
      • macOS 10.13
      • TVOS 12
      • WatchOS 6

  • ตั้งค่าอุปกรณ์ 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. คลิก Download GoogleService-Info.plist เพื่อรับไฟล์การกำหนดค่าแพลตฟอร์ม Firebase Apple (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 ดูข้อมูลเพิ่มเติมเกี่ยวกับไลบรารีแพลตฟอร์ม Firebase Apple เหล่านี้

บริการหรือผลิตภัณฑ์ พ็อด ไลบรารีของ SwiftPM เพิ่ม Analytics ไหม
AdMob pod 'Google-Mobile-Ads-SDK' ไม่มี
ข้อมูลวิเคราะห์ pod 'FirebaseAnalytics' FirebaseAnalytics
การตรวจสอบแอป pod 'FirebaseAppCheck' FirebaseAppCheck
การแจกจ่ายแอป pod 'FirebaseAppDistribution' FirebaseAppDistribution
การตรวจสอบสิทธิ์ pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase SDK pod 'FirebaseFunctions' FirebaseFunctions
การรับส่งข้อความในระบบคลาวด์ pod 'FirebaseMessaging' FirebaseMessaging
พื้นที่เก็บข้อมูลระบบคลาวด์ pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
ลิงก์แบบไดนามิก pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
การรับส่งข้อความในแอป pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(ต้องระบุ)
การติดตั้ง Firebase pod 'FirebaseInstallations' FirebaseInstallations
API โมเดลที่กำหนดเองของ Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
การตรวจสอบประสิทธิภาพ pod 'FirebasePerformance' FirebasePerformance
ฐานข้อมูลเรียลไทม์ pod 'FirebaseDatabase' FirebaseDatabase
การกำหนดค่าระยะไกล pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI สำหรับ Firebase ไม่มี FirebaseVertexAI-Preview

ผสานรวมโดยไม่ใช้ 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. เพิ่มแฟล็ก Linker -ObjC ใน Other Linker Settings ในการตั้งค่าบิลด์ของเป้าหมาย

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

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

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

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

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

  • จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย Cloud Firestore หรือฐานข้อมูลเรียลไทม์

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

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

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

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