ตัวเลือกในการติดตั้ง Firebase ในแอป Apple

ผู้จัดการแพ็กเกจของ Swift

Firebase แนะนำให้ใช้ Swift Package Manager สำหรับโปรเจ็กต์ใหม่

ผ่าน Xcode

การรองรับ Swift Package Manager ต้องใช้เวอร์ชัน 14.1 ขึ้นไป

  1. หากย้ายข้อมูลจากโปรเจ็กต์ที่ใช้ CocoaPods ให้เรียกใช้ pod deintegrate เพื่อนำ CocoaPods ออกจากโปรเจ็กต์ Xcode หลังจากนั้นไฟล์ .xcworkspace ที่ CocoaPods สร้างขึ้นจะลบออกได้อย่างปลอดภัย หากคุณกำลังเพิ่ม Firebase ไปยังโปรเจ็กต์เป็นครั้งแรก คุณสามารถข้ามขั้นตอนนี้ได้

  2. ใน Xcode ให้ติดตั้งไลบรารี Firebase โดยไปที่ ไฟล์ > เพิ่มแพ็กเกจ

  3. ในข้อความแจ้งที่ปรากฏขึ้น ให้เลือกที่เก็บ Firebase GitHub:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. เลือกเวอร์ชัน Firebase ที่ต้องการใช้ สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ใช้ Firebase เวอร์ชันใหม่ล่าสุด

  5. เลือกไลบรารี Firebase ที่ต้องการรวมไว้ในแอป

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

ผ่าน Package.swift

หากต้องการผสานรวม Firebase กับแพ็กเกจ Swift ผ่านไฟล์ Manifest Package.swift คุณเพิ่ม Firebase ลงในอาร์เรย์ dependencies ของแพ็กเกจได้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบเกี่ยวกับเครื่องมือจัดการแพ็กเกจของ Swift

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

จากนั้นเพิ่มลงในอาร์เรย์ dependencies ของเป้าหมายนั้นในเป้าหมายที่ขึ้นอยู่กับผลิตภัณฑ์ Firebase

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

ข้อควรพิจารณาเฉพาะผลิตภัณฑ์

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

Google Analytics

Google Analytics จำเป็นต้องเพิ่ม Flag -ObjC ลงในการตั้งค่าบิลด์ของเป้าหมาย หากรวมไว้ด้วยชั่วคราว

Crashlytics

Crashlytics กำหนดให้คุณต้องอัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่อง

คุณสามารถใช้ขั้นตอนการสร้างสคริปต์สำหรับ Xcode เพื่ออัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่องหลังการสร้าง หาสคริปต์การเรียกใช้ได้ที่นี่

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

อีกทางเลือกหนึ่งในการอัปโหลดสัญลักษณ์คือการใช้สคริปต์ upload-symbols วางสคริปต์ในไดเรกทอรีย่อยของไฟล์โปรเจ็กต์ (เช่น scripts/upload-symbols) จากนั้นตรวจสอบว่าสคริปต์ดังกล่าวเรียกใช้ได้ ดังนี้

chmod +x scripts/upload-symbols

คุณสามารถใช้สคริปต์นี้เพื่ออัปโหลดไฟล์ dSYM ด้วยตนเองได้ สำหรับหมายเหตุการใช้งานและคำแนะนำเพิ่มเติมสำหรับสคริปต์ ให้เรียกใช้ upload-symbols โดยไม่มีพารามิเตอร์ใดๆ

CocoaPods

Firebase รองรับการติดตั้งด้วย CocoaPods นอกเหนือจาก Swift Package Manager

การเผยแพร่ CocoaPods ของ Firebase ต้องใช้ Xcode 14.1 และ CocoaPods 1.12.0 ขึ้นไป นี่คือวิธีติดตั้ง Firebase โดยใช้ CocoaPods

  1. สร้าง Podfile หากยังไม่มี จากรูทของไดเรกทอรีโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้

    pod init
  2. ไปที่ Podfile ให้เพิ่มพ็อด Firebase ที่ต้องการใช้ในแอป

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

    เปิดใช้ Analytics แล้ว

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # 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 'FirebaseAuth'
    pod 'FirebaseFirestore'

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

    ไม่ได้เปิดใช้ Analytics

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'FirebaseAuth'
    pod 'FirebaseFirestore'
  3. ติดตั้งพ็อดแล้วเปิดไฟล์ .xcworkspace เพื่อดูโปรเจ็กต์ใน Xcode:

    pod install --repo-update
    open your-project.xcworkspace

ข้อควรพิจารณาเฉพาะผลิตภัณฑ์

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

Crashlytics

Crashlytics กำหนดให้คุณต้องอัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่อง

คุณสามารถใช้ขั้นตอนการสร้างสคริปต์สำหรับ Xcode เพื่ออัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่องหลังการสร้าง หาสคริปต์การเรียกใช้ได้ที่นี่

"${PODS_ROOT}/FirebaseCrashlytics/run"

คาร์เธจ

การสนับสนุนของ Carthage อยู่ในขั้นทดลอง ดู วิธีการใน GitHub สำหรับการรวม Firebase ไว้ในแอปผ่าน Carthage

ผสานรวมด้วยตนเอง

Firebase มีการกระจาย XCFramework แบบไบนารีที่สร้างไว้ล่วงหน้าสำหรับผู้ใช้ที่ต้องการผสานรวม Firebase โดยไม่ใช้ตัวจัดการการอ้างอิง วิธีติดตั้ง Firebase

  1. ดาวน์โหลด zip ของเฟรมเวิร์ก SDK ไฟล์นี้มีชิ้นส่วนสถาปัตยกรรมของสถาปัตยกรรมเป้าหมายที่มีอยู่ทั้งหมดสำหรับ Firebase SDK ทั้งหมด จึงอาจต้องใช้เวลาในการดาวน์โหลด

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

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