ตัวเลือกในการติดตั้ง 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 จะเริ่มจับคู่ข้อมูลและดาวน์โหลดทรัพยากร Dependency ของแพ็กเกจในเบื้องหลัง

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

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

   pod init

   หมายเหตุ: Podfile ต้องมี use_frameworks! (การลิงก์แบบไดนามิก) หรือ use_frameworks! :linkage => :static โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบเกี่ยวกับการลิงก์ไลบรารี Firebase แบบคงที่หรือแบบไดนามิก

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 ‘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'

   ระบบจะผสานรวม Dependency ของ Firebase แบบไบนารีเป็นเฟรมเวิร์กแบบคงที่โดยค่าเริ่มต้น หากคุณใช้ Firebase เป็นทรัพยากรของเฟรมเวิร์กแบบไดนามิก โปรดอ่านเอกสารประกอบเกี่ยวกับการใช้ Firebase จากเฟรมเวิร์กหรือไลบรารี

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 ให้กับตัวเลือกคอมไพเลอร์ ในการตั้งค่าการสร้างของเป้าหมายOther Linker Settings