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

ผู้จัดการแพ็คเกจ Swift

เริ่มต้นด้วยเวอร์ชัน 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 โดยไปที่ File > Add Packages

3. ในพรอมต์ที่ปรากฏขึ้น ให้เลือกที่เก็บ Firebase GitHub:

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

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

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

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

ผ่าน 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 กำหนดให้เพิ่มแฟล็กตัวเชื่อมโยง -ObjC ในการตั้งค่าการสร้างเป้าหมายของคุณ หากรวมไว้เป็นระยะๆ

แครชไลติค

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 โดยไม่มีพารามิเตอร์ใดๆ

ฝักโกโก้

Firebase รองรับการติดตั้งด้วย CocoaPods นอกเหนือจาก Swift Package Manager

การกระจาย CocoaPods ของ Firebase ต้องใช้ Xcode 13.3.1 และ CocoaPods 1.10.0 หรือสูงกว่า ต่อไปนี้เป็นวิธีติดตั้ง Firebase โดยใช้ CocoaPods:

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

   pod init

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

   คุณสามารถเพิ่ม ผลิตภัณฑ์ 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 กำหนดให้คุณอัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่อง

คุณสามารถใช้ขั้นตอนการสร้างสคริปต์การรันสำหรับ Xcode เพื่ออัปโหลดสัญลักษณ์การดีบักโดยอัตโนมัติหลังการสร้าง ค้นหาสคริปต์การทำงานที่นี่:

"${PODS_ROOT}/FirebaseCrashlytics/run"

คาร์เธจ

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

ผสานรวมด้วยตนเอง

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

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

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

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