เพิ่ม 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. คลิกดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์การกำหนดค่าแพลตฟอร์ม Apple ของ Firebase (GoogleService-Info.plist)

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

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

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

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

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

    หากเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase อย่าลืมเพิ่ม FirebaseAnalytics สำหรับ Analytics ที่ไม่สามารถรวบรวม IDFA ให้เพิ่ม FirebaseAnalyticsWithoutAdId แทน

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

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

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

  1. นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate รวมถึงโมดูล Firebase อื่นๆ ที่แอปมอบสิทธิ์ของคุณใช้ เช่น หากต้องการใช้ Cloud Firestore และการตรวจสอบสิทธิ์ ให้ทำดังนี้

    รหัส 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 คุณต้องปิดใช้การมอบสิทธิ์แอปด้วย ดูข้อมูลเพิ่มเติมได้ในวิธีการของ SwftUI

    รหัส 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

บริการหรือผลิตภัณฑ์ พ็อด ไลบรารีของ SwftPM เพิ่ม Analytics ไหม
AdMob pod 'Google-Mobile-Ads-SDK' ไม่มี
ข้อมูลวิเคราะห์ pod 'FirebaseAnalytics' FirebaseAnalytics
การตรวจสอบแอป pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
การตรวจสอบสิทธิ์ pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
SDK ของไคลเอ็นต์ Cloud สำหรับ Firebase 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 อีกด้วย โปรดดูรายละเอียดที่ README สำหรับ SDK ของ Firebase Apple Platform README บน GitHub

  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 Functions

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

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