Swift Package Manager
Firebase ขอแนะนำให้ใช้ Swift Package Manager สำหรับโปรเจ็กต์ใหม่
ผ่าน Xcode
การรองรับ Swift Package Manager ต้องใช้เวอร์ชัน 16.2 ขึ้นไป
หากย้ายข้อมูลจากโปรเจ็กต์ที่ใช้ CocoaPods ให้เรียกใช้
pod deintegrate
เพื่อนำ CocoaPods ออกจากโปรเจ็กต์ Xcode คุณสามารถลบไฟล์.xcworkspace
ที่ CocoaPods สร้างขึ้นได้อย่างปลอดภัยในภายหลัง หากคุณเพิ่ม Firebase ลงในโปรเจ็กต์เป็นครั้งแรก ก็ไม่ต้องสนใจขั้นตอนนี้ใน Xcode ให้ติดตั้งไลบรารี Firebase โดยไปที่File > Add Packages
ในพรอมต์ที่ปรากฏ ให้เลือกที่เก็บ GitHub ของ Firebase ดังนี้
https://github.com/firebase/firebase-ios-sdk.git
เลือกเวอร์ชัน Firebase ที่ต้องการใช้ สําหรับโปรเจ็กต์ใหม่ เราขอแนะนําให้ใช้ Firebase เวอร์ชันล่าสุด
เลือกไลบรารี Firebase ที่ต้องการรวมไว้ในแอป
หลังจากดำเนินการเสร็จแล้ว Xcode จะเริ่มแก้ไขการขึ้นต่อกันของแพ็กเกจและดาวน์โหลดไว้ในเบื้องหลัง
ผ่าน Package.swift
หากต้องการผสานรวม Firebase กับแพ็กเกจ Swift ผ่านPackage.swift
ไฟล์ Manifest คุณสามารถ
เพิ่ม 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
โดยไม่มีพารามิเตอร์
CocoaPods
Firebase รองรับการติดตั้งด้วย CocoaPods นอกเหนือจาก Swift Package Manager
การเผยแพร่ CocoaPods ของ Firebase ต้องใช้ Xcode 16.2 และ CocoaPods 1.12.0 ขึ้นไป วิธีติดตั้ง Firebase โดยใช้ CocoaPods มีดังนี้
หากยังไม่มี Podfile ให้สร้างโดยเรียกใช้คำสั่งต่อไปนี้ จากรูทของไดเรกทอรีโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้
pod init
เพิ่ม Pod ของ Firebase ที่ต้องการใช้ในแอปไปยัง Podfile
คุณเพิ่มผลิตภัณฑ์ Firebase ที่รองรับลงในแอปได้
# Add the Firebase pod for Google Analytics pod 'FirebaseAnalytics' # For Analytics without IDFA collection capability, use this pod instead # pod FirebaseAnalytics/Core # 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 ซึ่งเป็นตัวระบุโฆษณาระดับอุปกรณ์ได้ในเอกสารประกอบ ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล และ App Tracking Transparency ของ 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'
ติดตั้งพ็อด แล้วเปิดไฟล์
.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
ดาวน์โหลด SDK zip ของเฟรมเวิร์ก ไฟล์นี้มีส่วนย่อยของสถาปัตยกรรม สําหรับสถาปัตยกรรมเป้าหมายที่มีอยู่ทั้งหมดสําหรับ Firebase SDK ทั้งหมด จึงอาจใช้เวลาสักครู่ในการดาวน์โหลด
คลายซิปไฟล์ แล้วตรวจสอบ
README
สำหรับเฟรมเวิร์กที่ต้องการ รวมไว้ในแอปเพิ่ม
-ObjC
linker flag ในOther Linker Settings
ในการตั้งค่าบิลด์ของเป้าหมาย