ติดตั้ง Firebase ในแอป Apple

Swift Package Manager

เริ่มต้นด้วยเวอร์ชัน 8.0.0 ของ Firebase Apple SDK การสนับสนุน Swift Package Manager ของ Firebase ออกจากรุ่นเบต้าและโดยทั่วไปพร้อมให้ใช้งาน CocoaPods ไม่จำเป็นสำหรับผู้ใช้ Swift Package Manager

สำหรับ Firebase เวอร์ชัน 8 ขึ้นไป Swift Package Manager คือวิธีการติดตั้งที่แนะนำ

ผ่าน Xcode

การสนับสนุน Swift Package Manager ต้องการ 13.3.1 หรือสูงกว่า

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

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

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

   https://github.com/firebase/firebase-ios-sdk.git
   

4. เลือกเวอร์ชันของ Firebase ที่คุณต้องการใช้ สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ใช้ Firebase เวอร์ชันล่าสุด

5. เลือกไลบรารี Firebase ที่คุณต้องการรวมไว้ในแอปของคุณ

เมื่อคุณทำเสร็จแล้ว Xcode จะเริ่มแก้ไขการขึ้นต่อกันของแพ็คเกจของคุณและดาวน์โหลดในพื้นหลัง

ผ่าน Package.swift

ในการผสานรวม Firebase เข้ากับแพ็คเกจ Swift ผ่านรายการ 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 จำเป็นต้องเพิ่ม -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 13.3.1 และ CocoaPods 1.10.0 ขึ้นไป วิธีติดตั้ง Firebase โดยใช้ CocoaPods มีดังนี้

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

   pod init

2. ใน Podfile ของคุณ ให้เพิ่ม Firebase Pod ที่คุณต้องการใช้ในแอปของคุณ

   คุณเพิ่ม ผลิตภัณฑ์ Firebase ที่รองรับ ลงในแอปได้

   เปิดใช้งานการวิเคราะห์

   # 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 และ ความโปร่งใสในการติดตามแอป

   ไม่ได้เปิดใช้งานการวิเคราะห์

   # 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"

คาร์เธจ

การสนับสนุนคาร์เธจอยู่ในขั้นทดลอง ดู คำแนะนำใน GitHub ในการรวม Firebase ในแอปของคุณผ่าน Carthage

บูรณาการด้วยตนเอง

Firebase มีการกระจาย XCFramework แบบไบนารีที่สร้างไว้ล่วงหน้าสำหรับผู้ใช้ที่ต้องการผสานรวม Firebase โดยไม่ต้องใช้ตัวจัดการการพึ่งพา ในการติดตั้ง Firebase:

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

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

3. เพิ่ม แฟล็กตัวเชื่อมโยง -ObjC ในการตั้งค่าตัว Other Linker Settings ของคุณในการตั้งค่าการสร้างเป้าหมายของคุณ