ตัวเลือกในการติดตั้ง 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. เพิ่ม Firebase Pod ที่ต้องการใช้ในแอปของคุณลงใน 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 ซึ่งเป็นตัวระบุโฆษณาระดับอุปกรณ์ได้ในเอกสารประกอบเกี่ยวกับความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูลและความโปร่งใสในการติดตามแอปของ 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 โดยไม่ต้องใช้เครื่องมือจัดการทรัพยากร Dependency วิธีติดตั้ง Firebase

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

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

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