ติดตั้ง 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 โดยไปที่ ไฟล์ > เพิ่มแพ็คเกจ

  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 ลงในการตั้งค่าบิวด์ของเป้าหมายของคุณ หากมีการรวมแบบทรานซิชัน

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

โกโก้พอดส์

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

การแจกจ่าย CocoaPods ของ Firebase ต้องใช้ Xcode 14.1 และ CocoaPods 1.12.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

Crashlytics กำหนดให้คุณต้องอัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่อง

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

คาร์เธจ

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

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

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

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

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

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