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

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

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

ผ่าน Xcode

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

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 กำหนดให้เพิ่มค่าสถานะ 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 14.1 และ 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 ‘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 ซึ่งเป็นตัวระบุโฆษณาระดับอุปกรณ์ใน ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล และ ความโปร่งใสในการติดตามแอป เอกสารประกอบ

   ไม่ได้เปิดใช้ 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 Manager วิธีติดตั้ง Firebase

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

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

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