ตัวเลือกในการติดตั้ง 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

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

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

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

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