Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

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

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

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

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

    • โครงการของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
      • iOS 11
      • แมคโอเอส 10.13
      • tvOS 12
      • วอทช์โอเอส 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 ID

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

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

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

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

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

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

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

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

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

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

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

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

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

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    สวิฟต์

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

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

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

    SwiftUI

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

    สวิฟต์

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

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

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. หากคุณใช้ SwiftUI คุณต้องสร้างตัวแทนแอปพลิเคชันและแนบกับโครงสร้าง App ของคุณผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้งานการ swizzling ของผู้รับมอบสิทธิ์แอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ SwiftUI

    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 เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารีแพลตฟอร์ม 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
แครชไลติค 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

ผสานรวมโดยไม่ต้องใช้ Swift Package Manager

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

ฝักโกโก้

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

กรอบงาน

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

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

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

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

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

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

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

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

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

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

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

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

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

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

,

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

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

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

    • โครงการของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
      • iOS 11
      • แมคโอเอส 10.13
      • tvOS 12
      • วอทช์โอเอส 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 ID

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

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

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

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

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

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

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

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

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

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

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

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

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

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    สวิฟต์

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

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

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

    SwiftUI

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

    สวิฟต์

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

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

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. หากคุณใช้ SwiftUI คุณต้องสร้างตัวแทนแอปพลิเคชันและแนบกับโครงสร้าง App ของคุณผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้งานการ swizzling ของผู้รับมอบสิทธิ์แอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ SwiftUI

    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 เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารีแพลตฟอร์ม 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
แครชไลติค 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

ผสานรวมโดยไม่ต้องใช้ Swift Package Manager

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

ฝักโกโก้

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

กรอบงาน

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

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

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

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

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

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

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

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

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

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

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

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

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

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