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

เครื่องมือจัดการแพ็กเกจ Swift

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

ผ่าน Xcode

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

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

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

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

   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 -ObjC ของ Linker ลงในเป้าหมาย การตั้งค่าบิลด์หากรวมไว้ในทางอ้อม

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 15.2 และ CocoaPods 1.12.0 ขึ้นไป วิธีติดตั้ง Firebase ที่ใช้ CocoaPods

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

   pod init

   หมายเหตุ: Podfile ต้องมี use_frameworks! (การลิงก์แบบไดนามิก) หรือ use_frameworks! :linkage => :static โปรดดูเอกสารใน การลิงก์ทรัพยากร Dependency ของ 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 Manager วิธีติดตั้ง Firebase

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

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

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