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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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 คุณต้องปิดใช้งานการสลับตัวแทนของแอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ 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 เพิ่มการวิเคราะห์?
แอดโมบ pod 'Google-Mobile-Ads-SDK' ไม่มี
การวิเคราะห์ pod 'FirebaseAnalytics' FirebaseAnalytics
ตรวจสอบแอป pod 'FirebaseAppCheck' FirebaseAppCheck
การเผยแพร่แอป pod 'FirebaseAppDistribution' FirebaseAppDistribution
การรับรองความถูกต้อง pod 'FirebaseAuth' FirebaseAuth
คลาวด์ไฟร์สโตร์ 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
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 SDK README บน GitHub

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

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

    คุณสามารถดูคำแนะนำในการผสานรวมได้จากที่ใดที่หนึ่งต่อไปนี้:

    สำหรับข้อมูลเกี่ยวกับเวอร์ชันของเฟรมเวิร์กหรือการขึ้นต่อกัน โปรดดูไฟล์ METADATA.md ภายในไฟล์ zip ที่ดาวน์โหลด

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

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

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

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

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

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

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

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

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

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

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