ตัวเลือกในการติดตั้ง 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 ผ่าน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 26.2 และ CocoaPods 1.12.0 ขึ้นไป วิธีติดตั้ง Firebase โดยใช้ CocoaPods มีดังนี้

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

   pod init

2. เพิ่มพ็อด 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. ติดตั้งพ็อด แล้วเปิดไฟล์ .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. เพิ่ม-ObjC linker flag ใน Other Linker Settings ในการตั้งค่าบิลด์ของเป้าหมาย