เพิ่ม Firebase ให้กับโครงการ Apple ของคุณ

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

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

    • Xcode 13.3.1 หรือใหม่กว่า

  • ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:

    • โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
      • iOS 10
      • macOS 10.12
      • 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. (ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ: ชื่อเล่น แอป และ ID App Store

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

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

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

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

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

ขั้นตอนที่ 4 : เพิ่ม Firebase SDK ให้กับแอปของคุณ

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

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

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

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

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

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

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

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    วัตถุประสงค์-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ FirebaseApp โดยทั่วไปในเครื่องมือเริ่มต้นของ App ปหรือวิธีการของ application(_:didFinishLaunchingWithOptions:) ของแอปหรือผู้รับมอบสิทธิ์แอป:

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    วัตถุประสงค์-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. หากคุณรวม Firebase SDK สำหรับ Google Analytics ไว้ด้วย คุณสามารถเรียกใช้แอปเพื่อส่งการยืนยันไปยังคอนโซล Firebase ที่คุณติดตั้ง Firebase สำเร็จแล้ว

แค่นั้นแหละ! คุณสามารถข้ามไปยัง ขั้นตอนถัดไป ได้

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

ห้องสมุดที่มีอยู่

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

  • เอกสารอ้างอิง ( Swift | Obj-C )

  • Firebase Apple แพลตฟอร์ม SDK GitHub repo

บริการหรือสินค้า ฝัก ไลบรารี SwiftPM เพิ่มการวิเคราะห์?
AdMob pod 'Google-Mobile-Ads-SDK' ไม่มี
การวิเคราะห์ pod 'FirebaseAnalytics' FirebaseAnalytics
ตรวจสอบแอพ pod 'FirebaseAppCheck' FirebaseAppCheck
การกระจายแอพ pod 'FirebaseAppDistribution' FirebaseAppDistribution
การตรวจสอบสิทธิ์ pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
การส่งข้อความบนคลาวด์ pod 'FirebaseMessaging' FirebaseMessaging
การจัดเก็บเมฆ pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
ลิงก์แบบไดนามิก pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
การส่งข้อความในแอป pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(ที่จำเป็น)
การติดตั้ง Firebase pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Custom Model APIs pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
การตรวจสอบประสิทธิภาพ pod 'FirebasePerformance' FirebasePerformance
ฐานข้อมูลเรียลไทม์ pod 'FirebaseDatabase' FirebaseDatabase
การกำหนดค่าระยะไกล pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

บูรณาการโดยไม่ต้องใช้ Swift Package Manager

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

CocoaPods

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

กรอบงาน

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

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

  2. แตกไฟล์ จากนั้นตรวจสอบ README สำหรับกรอบงานที่คุณต้องการรวมไว้ในแอพของคุณ

  3. เพิ่ม แฟล็กตัวเชื่อมโยง -ObjC ในการตั้งค่าตัว Other Linker Settings ของคุณในการตั้งค่าการสร้างเป้าหมายของคุณ

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

เรียนรู้เกี่ยวกับ Firebase:

เพิ่มบริการ Firebase ในแอปของคุณ:

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

  • ตั้งค่าการพิสูจน์ตัวตนผู้ใช้ด้วย Authentication

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

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

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

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

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