Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

Swift Package Manager

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

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

ผ่าน Xcode

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

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

  2. ใน Xcode ติดตั้งห้องสมุด Firebase โดยไปที่ File> สวิฟท์แพคเกจ> เพิ่มแพคเกจการพึ่งพา ...

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

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. เลือกเวอร์ชันของ Firebase ที่คุณต้องการใช้ สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ใช้ Firebase เวอร์ชันล่าสุด

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

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

via Package.swift

เพื่อบูรณาการ Firebase แพคเกจสวิฟท์ผ่าน Package.swift ประจักษ์คุณสามารถเพิ่ม Firebase ไป dependencies อาร์เรย์ของแพคเกจของคุณ สำหรับรายละเอียดเพิ่มเติมโปรดดูที่ เอกสารสวิฟท์แพคเกจผู้จัดการ

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

CocoaPods

Firebase สนับสนุนการติดตั้งกับ CocoaPods นอกเหนือไปจากสวิฟท์แพคเกจผู้จัดการ

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

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

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

    คุณสามารถเพิ่มใด ๆ ของ ผลิตภัณฑ์ Firebase สนับสนุน แอปของคุณ

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

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

    เรียนรู้เพิ่มเติมเกี่ยว IDFA ระบุการโฆษณาระดับอุปกรณ์ในแอปเปิ้ลของ ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล และ App ติดตามความโปร่งใส เอกสาร

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

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. ติดตั้งฝักแล้วเปิดของคุณ .xcworkspace ของไฟล์เพื่อดูโครงการใน Xcode นี้:

    pod install --repo-update
    open your-project.xcworkspace

ข้อควรพิจารณาเฉพาะของผลิตภัณฑ์

ผลิตภัณฑ์ Firebase บางรายการต้องมีขั้นตอนการผสานรวมเพิ่มเติมเพื่อให้ทำงานได้อย่างถูกต้อง

Crashlytics

Crashlytics ต้องการให้คุณอัปโหลดสัญลักษณ์การดีบัก

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

คาร์เธจ

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

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

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

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

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

  3. เพิ่ม -ObjC ธงลิงเกอร์ ของคุณใน Other Linker Settings ในเป้าหมายของการตั้งค่าการสร้าง