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

Swift Package Manager

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

ผ่าน Xcode

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

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

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

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

   https://github.com/firebase/firebase-ios-sdk.git
   

4. เลือกเวอร์ชัน Firebase ที่ต้องการใช้ สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ใช้ Firebase เวอร์ชันล่าสุด

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

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

ผ่าน Package.swift

หากต้องการผสานรวม Firebase กับแพ็กเกจ Swift ผ่านไฟล์ Manifest Package.swift คุณสามารถเพิ่ม 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 กำหนดให้เพิ่มแฟล็ก Linker -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 26.2 และ CocoaPods 1.12.0 ขึ้นไป วิธีติดตั้ง Firebase โดยใช้ CocoaPods มีดังนี้

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

   pod init

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

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

   Analytics เปิดใช้งานแล้ว

   # 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

   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. ติดตั้ง Pod แล้วเปิดไฟล์ .xcworkspace เพื่อดูโปรเจ็กต์ใน Xcode

   pod install --repo-update

   open your-project.xcworkspace

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

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

Crashlytics

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

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

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

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

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

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

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

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