เครื่องมือจัดการแพ็กเกจ Swift
Firebase ขอแนะนำ Swift Package Manager สำหรับโปรเจ็กต์ใหม่
ผ่าน Xcode
การสนับสนุน Swift Package Manager ต้องใช้เวอร์ชัน 15.2 ขึ้นไป
หากย้ายข้อมูลจากโปรเจ็กต์ที่ใช้ 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 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 กำหนดให้เพิ่ม Flag -ObjC
ของ Linker ลงในเป้าหมาย
การตั้งค่าบิลด์หากรวมไว้ในทางอ้อม
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 15.2 และ CocoaPods 1.12.0 ขึ้นไป วิธีติดตั้ง Firebase ที่ใช้ CocoaPods
สร้าง Podfile หากคุณยังไม่มี จากราก ไดเรกทอรีโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้
pod init
เพิ่มพ็อด Firebase ที่คุณต้องการใช้ในแอปลงใน Podfile
คุณสามารถเพิ่มที่อยู่ใดๆ ผลิตภัณฑ์ 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 ซึ่งเป็นตัวระบุโฆษณาระดับอุปกรณ์ใน ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล และ ความโปร่งใสในการติดตามแอป เอกสารประกอบ
ไม่ได้เปิดใช้ 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
เพื่อดูโปรเจ็กต์ใน Xcodepod install --repo-update
open your-project.xcworkspace
ข้อควรพิจารณาเฉพาะผลิตภัณฑ์
ผลิตภัณฑ์ Firebase บางรายการต้องมีขั้นตอนการผสานรวมเพิ่มเติมจึงจะทำงานได้ อย่างถูกต้อง
Crashlytics
Crashlytics กำหนดให้คุณต้องอัปโหลดสัญลักษณ์สำหรับแก้ไขข้อบกพร่อง
คุณสามารถใช้เฟสเรียกใช้สคริปต์สำหรับ Xcode เพื่ออัปโหลดการแก้ไขข้อบกพร่องโดยอัตโนมัติ สัญลักษณ์หลังการสร้าง ค้นหาสคริปต์การทำงานได้ที่นี่:
"${PODS_ROOT}/FirebaseCrashlytics/run"
คาร์เธจ
การรองรับ Carthage อยู่ในขั้นทดลอง โปรดดู วิธีการเกี่ยวกับ GitHub สำหรับการรวม Firebase ไว้ในแอปผ่าน Carthage
ผสานรวมด้วยตนเอง
Firebase มีการกระจายไบนารี XCFramework ที่สร้างไว้ล่วงหน้าสำหรับผู้ใช้ที่ต้องการ เพื่อผสานรวม Firebase โดยไม่ใช้ Dependency Manager วิธีติดตั้ง Firebase
ดาวน์โหลดไฟล์ ZIP ของเฟรมเวิร์ก SDK ไฟล์นี้มีชิ้นส่วนสถาปัตยกรรม สําหรับสถาปัตยกรรมเป้าหมายที่มีอยู่ทั้งหมดสําหรับ Firebase SDK ทั้งหมด ดังนั้นจึงอาจ ใช้เวลาดาวน์โหลดสักครู่
แตกไฟล์ จากนั้นตรวจสอบ
README
เพื่อหาเฟรมเวิร์กที่คุณต้องการ รวมไว้ในแอปของคุณเพิ่ม
-ObjC
Linker Flag ในOther Linker Settings
ในการตั้งค่าบิลด์ของเป้าหมาย