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

Swift Package Manager

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