เพิ่ม Firebase ให้กับโปรเจ็กต์ Apple ของคุณ

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

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

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

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

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

  • ตั้งค่าอุปกรณ์ Apple จริงหรือใช้เครื่องจำลองเพื่อเรียกใช้แอปของคุณ

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

ขั้นตอนที่ 1: สร้างโครงการ Firebase

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

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

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

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

  1. ไปที่ คอนโซล Firebase

  2. ในใจกลางของหน้าภาพรวมโครงการให้คลิกที่ไอคอน iOS + เพื่อเปิดเวิร์กโฟลว์การติดตั้ง

    หากคุณได้เพิ่มแอพในโครงการ Firebase ของคุณให้คลิกเพิ่มแอปเพื่อแสดงตัวเลือกแพลตฟอร์ม

  3. ใส่รหัสชุดของแอปในฟิลด์รหัสชุด

  4. (อุปกรณ์เสริม) ป้อนข้อมูลตรวจสอบอื่น ๆ : ชื่อเล่น App และ App Store ID

  5. คลิกแอปสมัครสมาชิก

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

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

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

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

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

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการพึ่งพา 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 จะเริ่มแก้ไขและดาวน์โหลดการพึ่งพาของคุณในเบื้องหลังโดยอัตโนมัติ

ขั้นตอนที่ 5: การเตรียม Firebase ใน app ของคุณ

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

แค่นั้นแหละ! คุณสามารถข้ามไปข้างหน้าเพื่อ ทำตามขั้นตอนต่อไป

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

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

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

บริการหรือสินค้า ฝัก ไลบรารี 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, ซิปขณะนี้รวมถึง .xcframework ไฟล์ โปรดดูรายละเอียด ในแพลตฟอร์มแอปเปิ้ล Firebase SDK README บน GitHub

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

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

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

CocoaPods

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

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

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

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