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

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

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

    • Xcode 12.2 หรือใหม่กว่า
    • CocoaPods 1.10.0 หรือใหม่กว่า

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

    • โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเป็น iOS 10 หรือใหม่กว่า

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

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

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

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

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

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

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

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

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

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

  3. ใส่รหัสชุดของแอปในช่องรหัสกำ iOS

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

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

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

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

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

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

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

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

คุณกำลังใช้หนึ่งใน ตัวอย่าง QuickStart ? โครงการ Xcode และ Podfile (ฝัก) มีอยู่แล้ว แต่คุณยังจะต้อง เพิ่มการตั้งค่าไฟล์ Firebase ของคุณ และติดตั้งฝัก

  1. สร้าง Podfile หากคุณยังไม่มี:

    cd your-project-directory
    pod init

  2. ใน Podfile ของคุณ ให้เพิ่มพ็อด Firebase ที่คุณต้องการใช้ในแอปของคุณ

    คุณสามารถเพิ่มใด ๆ ของ ผลิตภัณฑ์ Firebase สนับสนุน ไปยังแอป iOS ของคุณ

    เปิดใช้งานการวิเคราะห์

    platform :ios, ‘10.0’
    
# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod ‘Firebase/AnalyticsWithoutAdIdSupport’

# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

    เรียนรู้เพิ่มเติมเกี่ยว IDFA ระบุการโฆษณาระดับอุปกรณ์ในแอปเปิ้ลของ ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล และ App ติดตามความโปร่งใส เอกสาร

    ไม่ได้เปิดใช้งานการวิเคราะห์

    platform :ios, ‘10.0’
    
# Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

  3. ติดตั้งฝักแล้วเปิดของคุณ .xcworkspace ของไฟล์เพื่อดูโครงการใน Xcode นี้:

    pod install
    open your-project.xcworkspace

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

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

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

ฝักที่มีจำหน่าย Available

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

บริการหรือสินค้า ฝัก เพิ่มการวิเคราะห์?
AdMob pod 'Google-Mobile-Ads-SDK'
การวิเคราะห์ pod 'Firebase/Analytics'
ตรวจสอบแอพ pod 'Firebase/AppCheck'
การกระจายแอพ pod 'Firebase/AppDistribution'
การตรวจสอบสิทธิ์ pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
ฟังก์ชันระบบคลาวด์สำหรับ Firebase Client SDK pod 'Firebase/Functions'
การส่งข้อความบนคลาวด์ pod 'Firebase/Messaging'
การจัดเก็บเมฆ pod 'Firebase/Storage'
Crashlytics pod 'Firebase/Crashlytics'
ลิงก์แบบไดนามิก pod 'Firebase/DynamicLinks'
การส่งข้อความในแอป pod 'Firebase/InAppMessaging'
(จำเป็น)
การติดตั้ง Firebase pod 'Firebase/Installations'
Firebase ML Custom Model APIs pod 'Firebase/MLModelDownloader'
การตรวจสอบประสิทธิภาพ pod 'Firebase/Performance'
ฐานข้อมูลเรียลไทม์ pod 'Firebase/Database'
การกำหนดค่าระยะไกล pod 'Firebase/RemoteConfig'

บูรณาการโดยไม่ต้อง CocoaPods

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

กรอบงาน

นอกจากการรองรับแพลตฟอร์ม iOS แล้ว ไฟล์ zip ยังรวมไฟล์ .xcframework ที่เพิ่มการรองรับ Catalyst ตามชุมชนอีกด้วย ดูรายละเอียด Firebase iOS SDK README บน GitHub

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

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

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

Swift Package Manager

เรียนรู้เพิ่มเติมเกี่ยวกับการรวมสวิฟท์แพคเกจ Manager ที่ปรากฏใน คำแนะนำของเรา

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

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

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