ผู้จัดการแพ็กเกจของ Swift
Firebase แนะนำให้ใช้ Swift Package Manager สำหรับโปรเจ็กต์ใหม่
ผ่าน Xcode
การรองรับ Swift Package Manager ต้องใช้เวอร์ชัน 14.1 ขึ้นไป
หากย้ายข้อมูลจากโปรเจ็กต์ที่ใช้ CocoaPods ให้เรียกใช้
pod deintegrate
เพื่อนำ CocoaPods ออกจากโปรเจ็กต์ Xcode หลังจากนั้นไฟล์.xcworkspace
ที่ CocoaPods สร้างขึ้นจะลบออกได้อย่างปลอดภัย หากคุณกำลังเพิ่ม Firebase ไปยังโปรเจ็กต์เป็นครั้งแรก คุณสามารถข้ามขั้นตอนนี้ได้ใน Xcode ให้ติดตั้งไลบรารี Firebase โดยไปที่ ไฟล์ > เพิ่มแพ็กเกจ
ในข้อความแจ้งที่ปรากฏขึ้น ให้เลือกที่เก็บ Firebase GitHub:
https://github.com/firebase/firebase-ios-sdk.git
เลือกเวอร์ชัน Firebase ที่ต้องการใช้ สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ใช้ Firebase เวอร์ชันใหม่ล่าสุด
เลือกไลบรารี Firebase ที่ต้องการรวมไว้ในแอป
เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขทรัพยากร Dependency ของแพ็กเกจและดาวน์โหลดไฟล์ในเบื้องหลัง
ผ่าน Package.swift
หากต้องการผสานรวม Firebase กับแพ็กเกจ Swift ผ่านไฟล์ Manifest Package.swift
คุณเพิ่ม Firebase ลงในอาร์เรย์ dependencies
ของแพ็กเกจได้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบเกี่ยวกับเครื่องมือจัดการแพ็กเกจของ Swift
dependencies: [
.package(name: "Firebase",
url: "https://github.com/firebase/firebase-ios-sdk.git",
from: "8.0"),
// ...
],
จากนั้นเพิ่มลงในอาร์เรย์ dependencies
ของเป้าหมายนั้นในเป้าหมายที่ขึ้นอยู่กับผลิตภัณฑ์ Firebase
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
ข้อควรพิจารณาเฉพาะผลิตภัณฑ์
ผลิตภัณฑ์ Firebase บางอย่างต้องมีขั้นตอนการผสานรวมเพิ่มเติมเพื่อให้ทำงานได้อย่างถูกต้อง
Google Analytics
Google Analytics จำเป็นต้องเพิ่ม Flag -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 นอกเหนือจาก Swift Package Manager
การเผยแพร่ CocoaPods ของ Firebase ต้องใช้ Xcode 14.1 และ CocoaPods 1.12.0 ขึ้นไป นี่คือวิธีติดตั้ง Firebase โดยใช้ CocoaPods
สร้าง Podfile หากยังไม่มี จากรูทของไดเรกทอรีโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้
pod init
ไปที่ Podfile ให้เพิ่มพ็อด Firebase ที่ต้องการใช้ในแอป
คุณสามารถเพิ่มผลิตภัณฑ์ Firebase ที่รองรับลงในแอปได้
เปิดใช้ Analytics แล้ว
# 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
ไม่ได้เปิดใช้ Analytics
# 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'
ติดตั้งพ็อดแล้วเปิดไฟล์
.xcworkspace
เพื่อดูโปรเจ็กต์ใน Xcode:pod install --repo-update
open your-project.xcworkspace
ข้อควรพิจารณาเฉพาะผลิตภัณฑ์
ผลิตภัณฑ์ Firebase บางอย่างต้องมีขั้นตอนการผสานรวมเพิ่มเติมเพื่อให้ทำงานได้อย่างถูกต้อง
Crashlytics
Crashlytics กำหนดให้คุณต้องอัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่อง
คุณสามารถใช้ขั้นตอนการสร้างสคริปต์สำหรับ Xcode เพื่ออัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่องหลังการสร้าง หาสคริปต์การเรียกใช้ได้ที่นี่
"${PODS_ROOT}/FirebaseCrashlytics/run"
คาร์เธจ
การสนับสนุนของ Carthage อยู่ในขั้นทดลอง ดู วิธีการใน GitHub สำหรับการรวม Firebase ไว้ในแอปผ่าน Carthage
ผสานรวมด้วยตนเอง
Firebase มีการกระจาย XCFramework แบบไบนารีที่สร้างไว้ล่วงหน้าสำหรับผู้ใช้ที่ต้องการผสานรวม Firebase โดยไม่ใช้ตัวจัดการการอ้างอิง วิธีติดตั้ง Firebase
ดาวน์โหลด zip ของเฟรมเวิร์ก SDK ไฟล์นี้มีชิ้นส่วนสถาปัตยกรรมของสถาปัตยกรรมเป้าหมายที่มีอยู่ทั้งหมดสำหรับ Firebase SDK ทั้งหมด จึงอาจต้องใช้เวลาในการดาวน์โหลด
แตกไฟล์ จากนั้นตรวจสอบ
README
สำหรับเฟรมเวิร์กที่คุณต้องการรวมไว้ในแอปเพิ่ม
-ObjC
Linker Flag ในOther Linker Settings
ในการตั้งค่าบิลด์ของเป้าหมาย