ติดตั้ง 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 โดยไปที่ 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 14.1 และ CocoaPods 1.10.0 ขึ้นไป ต่อไปนี้เป็นวิธีติดตั้ง Firebase โดยใช้ CocoaPods:

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

   pod init

   หมายเหตุ: Podfiles ต้องมี use_frameworks! (การเชื่อมโยงแบบไดนามิก) หรือ use_frameworks! :linkage => :static ; โปรดดูเอกสารเกี่ยวกับ การเชื่อมโยงการพึ่งพา Firebase แบบคงที่หรือแบบไดนามิก สำหรับรายละเอียดเพิ่มเติม

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