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

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

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

    • Xcode 14.1 ขึ้นไป

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

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

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

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

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

คุณต้องสร้าง Firebase ก่อนจึงจะเพิ่ม Firebase ลงในแอป Apple ได้ เพื่อเชื่อมต่อกับแอปของคุณ ไปที่เว็บไซต์ ทำความเข้าใจโปรเจ็กต์ 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 โปรดดูรายละเอียดที่ Firebase SDK README บนแพลตฟอร์ม Apple GitHub ที่ใช้เวลาเพียง 2 นาที

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

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

    โดยจะดูคำแนะนำการผสานรวมได้ในที่ใดที่หนึ่งต่อไปนี้

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

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

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

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

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

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

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

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

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

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

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

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