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

Swift Package Manager

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

ผ่าน Xcode

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

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

  2. ใน Xcode ให้ติดตั้งไลบรารี Firebase โดยไปที่File > Add Packages

  3. ในพรอมต์ที่ปรากฏ ให้เลือกที่เก็บ GitHub ของ Firebase ดังนี้

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

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

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

ผ่าน Package.swift

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

dependencies: [

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

],

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

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

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

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

Google Analytics

Google Analytics ต้องเพิ่มแฟล็กตัวเชื่อม -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 16.2 และ CocoaPods 1.12.0 ขึ้นไป วิธีติดตั้ง Firebase โดยใช้ CocoaPods มีดังนี้

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

    pod init
  2. เพิ่ม Pod ของ Firebase ที่ต้องการใช้ในแอปไปยัง Podfile

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

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # For Analytics without IDFA collection capability, use this pod instead
    # pod FirebaseAnalytics/Core
    
    # 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 ซึ่งเป็นตัวระบุโฆษณาระดับอุปกรณ์ได้ในเอกสารประกอบ ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล และ App Tracking Transparency ของ Apple

    # 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. ดาวน์โหลด SDK zip ของเฟรมเวิร์ก ไฟล์นี้มีส่วนย่อยของสถาปัตยกรรม สําหรับสถาปัตยกรรมเป้าหมายที่มีอยู่ทั้งหมดสําหรับ Firebase SDK ทั้งหมด จึงอาจใช้เวลาสักครู่ในการดาวน์โหลด

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

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