เพิ่ม Firebase ลงในโปรเจ็กต์ Apple

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

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

    • Xcode 16.2 ขึ้นไป
  • ตรวจสอบว่าโปรเจ็กต์เป็นไปตามข้อกำหนดต่อไปนี้

    • โปรเจ็กต์ต้องกำหนดเป้าหมายเป็นแพลตฟอร์มเวอร์ชันต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7
  • ตั้งค่าอุปกรณ์ Apple จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอป

    สำหรับ Cloud Messaging ในแพลตฟอร์ม Apple คุณต้องมีคุณสมบัติดังนี้

    • ตั้งค่าอุปกรณ์ Apple จริง
    • รับคีย์การตรวจสอบสิทธิ์ข้อความ Push ของ Apple สำหรับบัญชีนักพัฒนาแอปของ Apple
    • เปิดใช้ข้อความ Push ใน Xcode ในส่วนแอป > ความสามารถ

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

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

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

  1. ในFirebase คอนโซล ให้คลิกเพิ่มโปรเจ็กต์

    • หากต้องการเพิ่มทรัพยากร Firebase ลงในโปรเจ็กต์ที่มีอยู่ Google Cloud ให้ป้อนชื่อโปรเจ็กต์หรือเลือกจากเมนูแบบเลื่อนลง

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

  2. หากได้รับแจ้ง ให้อ่านและยอมรับข้อกำหนดของ Firebase

  3. คลิกต่อไป

  4. (ไม่บังคับ) ตั้งค่า Google Analytics สำหรับโปรเจ็กต์ ซึ่งจะ ช่วยให้ได้รับประสบการณ์การใช้งานที่ดียิ่งขึ้นเมื่อใช้ผลิตภัณฑ์ Firebase ต่อไปนี้ Firebase A/B Testing Cloud Messaging Crashlytics In-App Messaging และ Remote Config (รวมถึงการปรับเปลี่ยนในแบบของคุณ)

    เลือกบัญชี Google Analytics ที่มีอยู่ หรือสร้างบัญชีใหม่ หากสร้างบัญชีใหม่ ให้เลือกAnalyticsสถานที่ตั้งการรายงาน จากนั้นยอมรับการตั้งค่าการแชร์ข้อมูลและGoogle Analyticsข้อกำหนดสำหรับ โปรเจ็กต์

  5. คลิกสร้างโปรเจ็กต์ (หรือเพิ่ม Firebase หากคุณเพิ่ม Firebase ไปยังโปรเจ็กต์ Google Cloud ที่มีอยู่)

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

ขั้นตอนที่ 2: ลงทะเบียนแอปกับ Firebase

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

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

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

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

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

    • รหัสชุด ระบุแอปพลิเคชันในระบบนิเวศของ Apple ได้อย่างไม่ซ้ำกัน

    • ค้นหารหัสชุดซอฟต์แวร์: เปิดโปรเจ็กต์ใน Xcode เลือกแอป ระดับบนสุดในแถบนำทางโปรเจ็กต์ แล้วเลือกแท็บทั่วไป

      ค่าของช่องตัวระบุชุดคือรหัสชุด (เช่น com.yourcompany.yourproject)

    • โปรดทราบว่าค่า Bundle ID จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่สามารถ เปลี่ยนแปลงสำหรับแอป Firebase นี้ได้หลังจากลงทะเบียนกับ โปรเจ็กต์ Firebase แล้ว

  4. (ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ ดังนี้ ชื่อเล่นของแอปและรหัส App Store

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

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

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

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

    • คุณดาวน์โหลดไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ

    • โปรดตรวจสอบว่าชื่อไฟล์การกำหนดค่าไม่มีอักขระต่อท้ายเพิ่มเติม เช่น (2)

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

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

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

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

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

    หากเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase โปรดตรวจสอบ ว่าได้เพิ่ม FirebaseAnalytics แล้ว ซึ่งจะให้ฟีเจอร์การวิเคราะห์ทั้งหมด นอกจากนี้ คุณยังเลือกฟีเจอร์แต่ละรายการได้ด้วย โปรดดูคำถามที่พบบ่อยเกี่ยวกับการจัดระเบียบโมดูลล่าสุดใน Google Analytics สำหรับ Firebase SDK

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

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

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

  1. นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate รวมถึงโมดูล Firebase อื่นๆ ที่ตัวแทนแอปของคุณใช้ เช่น หากต้องการใช้ Cloud Firestore และ Authentication ให้ทำดังนี้
    SwiftUISwiftObjective-C
    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          
    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. กำหนดค่า FirebaseApp อินสแตนซ์ที่แชร์ใน เมธอด application(_:didFinishLaunchingWithOptions:) ของตัวแทนแอป
    SwiftUISwiftObjective-C
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    // 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 ดูข้อมูลเพิ่มเติมเกี่ยวกับไลบรารีแพลตฟอร์ม Apple ของ Firebase เหล่านี้

บริการหรือผลิตภัณฑ์ พ็อด ไลบรารี SwiftPM เพิ่ม Analytics ไหม
AdMob pod 'Google-Mobile-Ads-SDK' ไม่มี
Firebase AI Logic 1
pod 'FirebaseAI' FirebaseAI
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Data Connect ไม่มี FirebaseDataConnect
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(ต้องระบุ)
Firebase การติดตั้ง pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Custom Model API pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

1 ก่อนหน้านี้ Firebase AI Logic มีชื่อว่า "Vertex AI in Firebase" โดยมีพ็อด pod 'FirebaseVertexAI' และ SwiftPM Library FirebaseVertexAI

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

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

CocoaPods

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

เฟรมเวิร์ก

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

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

  2. แตกไฟล์ แล้วผสานรวมเฟรมเวิร์กที่ต้องการรวมไว้ในแอป

    คุณดูวิธีการผสานรวมได้จากที่ใดที่หนึ่งต่อไปนี้

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

  3. เพิ่ม -ObjCแฟล็กตัวลิงก์ ใน Other Linker Settings ในการตั้งค่าบิลด์ของเป้าหมาย

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

ดูข้อมูลเกี่ยวกับ Firebase

เพิ่มบริการ Firebase ไปยังแอป

  • สร้างฟีเจอร์ Generative AI ด้วยโมเดล Gemini และ Imagen โดยใช้ Firebase AI Logic

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

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

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

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

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

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

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