ติดตั้ง 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 ที่สร้างโดย CocoaPods สามารถลบออกได้อย่างปลอดภัยในภายหลัง หากคุณเพิ่ม 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'

   การพึ่งพาไบนารีของ Firebase ถูกรวมเป็นเฟรมเวิร์กแบบสแตติกตามค่าเริ่มต้น หากคุณใช้ Firebase เป็นการอ้างอิงของเฟรมเวิร์กแบบไดนามิก โปรดอ่านเอกสารประกอบเกี่ยวกับ การใช้ Firebase จากเฟรมเวิร์กหรือไลบรารี

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 ของคุณในการตั้งค่าการสร้างเป้าหมายของคุณ