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

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

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

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

    • โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
      • iOS 10
      • macOS 10.12
      • tvOS 12
      • watchOS 6
  • ตั้งค่าอุปกรณ์ Apple จริงหรือใช้เครื่องจำลองเพื่อเรียกใช้แอปของคุณ

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

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

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

ขั้นตอนที่ 2 : ลงทะเบียนแอปของคุณด้วย Firebase

หลังจากที่คุณมีโปรเจ็กต์ Firebase แล้ว คุณสามารถเพิ่มแอป Apple ลงไปได้

ไปที่ "ทำความเข้าใจโปรเจ็กต์ Firebase " เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุดและข้อควรพิจารณาในการเพิ่มแอปลงในโปรเจ็กต์ 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 > Swift Packages > Add Package Dependency
  2. เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ SDK ของแพลตฟอร์ม Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. เลือกเวอร์ชัน SDK ที่คุณต้องการใช้
  5. เลือกไลบรารี Firebase ที่คุณต้องการใช้

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

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

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

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

  1. นำเข้าโมดูล Firebase ใน UIApplicationDelegate ของคุณ:

    Swift

    import Firebase

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

    @import Firebase;
  2. กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ FirebaseApp โดยทั่วไปจะอยู่ใน 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 'Firebase/Analytics' FirebaseAnalytics
ตรวจสอบแอพ pod 'Firebase/AppCheck' FirebaseAppCheck
การกระจายแอพ pod 'Firebase/AppDistribution' FirebaseAppDistribution
การตรวจสอบสิทธิ์ pod 'Firebase/Auth' FirebaseAuth
Cloud Firestore pod 'Firebase/Firestore' FirebaseFirestore
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK pod 'Firebase/Functions' FirebaseFunctions
การส่งข้อความบนคลาวด์ pod 'Firebase/Messaging' FirebaseMessaging
การจัดเก็บเมฆ pod 'Firebase/Storage' FirebaseStorage
Crashlytics pod 'Firebase/Crashlytics' FirebaseCrashlytics
ลิงก์แบบไดนามิก pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
การส่งข้อความในแอป pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
(ที่จำเป็น)
การติดตั้ง Firebase pod 'Firebase/Installations' FirebaseInstallations
Firebase ML Custom Model APIs pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
การตรวจสอบประสิทธิภาพ pod 'Firebase/Performance' FirebasePerformance
ฐานข้อมูลเรียลไทม์ pod 'Firebase/Database' FirebaseDatabase
การกำหนดค่าระยะไกล pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

บูรณาการโดยไม่มีตัวจัดการการพึ่งพา

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

กรอบงาน

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

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

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

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

CocoaPods

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

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

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

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

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

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

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

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

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

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

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