ผู้จัดการแพ็คเกจ Swift
เริ่มต้นด้วยเวอร์ชัน 8.0.0 ของ Firebase Apple SDK การสนับสนุน Swift Package Manager ของ Firebase ยังไม่อยู่ในรุ่นเบต้าและพร้อมใช้งานโดยทั่วไป ไม่จำเป็นต้องใช้ CocoaPods สำหรับผู้ใช้ Swift Package Manager
สำหรับ Firebase เวอร์ชัน 8 ขึ้นไป Swift Package Manager เป็นวิธีการติดตั้งที่แนะนำ
ผ่าน Xcode
การสนับสนุน Swift Package Manager ต้องการ 13.3.1 หรือสูงกว่า
หากย้ายจากโปรเจ็กต์ที่ใช้ CocoaPods ให้เรียกใช้
pod deintegrate
เพื่อลบ CocoaPods ออกจากโปรเจ็กต์ Xcode ของคุณ ไฟล์ ..xcworkspace
ที่สร้างโดย CocoaPods สามารถลบออกได้อย่างปลอดภัยในภายหลัง หากคุณเพิ่ม Firebase ให้กับโปรเจ็กต์เป็นครั้งแรก คุณสามารถละเว้นขั้นตอนนี้ได้ใน Xcode ให้ติดตั้งไลบรารี Firebase โดยไปที่ File > Add Packages
ในพรอมต์ที่ปรากฏขึ้น ให้เลือกที่เก็บ Firebase GitHub:
https://github.com/firebase/firebase-ios-sdk.git
เลือกเวอร์ชันของ Firebase ที่คุณต้องการใช้ สำหรับโครงการใหม่ เราขอแนะนำให้ใช้ Firebase เวอร์ชันใหม่ล่าสุด
เลือกไลบรารี Firebase ที่คุณต้องการรวมไว้ในแอปของคุณ
เมื่อคุณทำเสร็จแล้ว Xcode จะเริ่มแก้ไขการขึ้นต่อกันของแพ็คเกจและดาวน์โหลดในเบื้องหลัง
ผ่าน 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 กำหนดให้เพิ่มแฟล็กตัวเชื่อมโยง -ObjC
ในการตั้งค่าการสร้างเป้าหมายของคุณ หากรวมไว้เป็นระยะๆ
แครชไลติค
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 13.3.1 และ CocoaPods 1.10.0 หรือสูงกว่า ต่อไปนี้เป็นวิธีติดตั้ง Firebase โดยใช้ CocoaPods:
สร้าง Podfile หากคุณยังไม่มี จากรูทของไดเร็กทอรีโปรเจ็กต์ของคุณ ให้รันคำสั่งต่อไปนี้:
pod init
ใน 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'
ติดตั้งพ็อด จากนั้นเปิดไฟล์
.xcworkspace
เพื่อดูโปรเจ็กต์ใน Xcode:pod install --repo-update
open your-project.xcworkspace
การพิจารณาเฉพาะผลิตภัณฑ์
ผลิตภัณฑ์ Firebase บางอย่างต้องการขั้นตอนการผสานรวมเพิ่มเติมเพื่อให้ทำงานได้อย่างถูกต้อง
แครชไลติค
Crashlytics กำหนดให้คุณอัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่อง
คุณสามารถใช้ขั้นตอนการสร้างสคริปต์การรันสำหรับ Xcode เพื่ออัปโหลดสัญลักษณ์การดีบักโดยอัตโนมัติหลังการสร้าง ค้นหาสคริปต์การทำงานที่นี่:
"${PODS_ROOT}/FirebaseCrashlytics/run"
คาร์เธจ
การสนับสนุนคาร์เธจเป็นการทดลอง ดู คำแนะนำบน GitHub สำหรับการรวม Firebase ในแอปของคุณผ่าน Carthage
ผสานรวมด้วยตนเอง
Firebase มีการแจกจ่าย XCFramework แบบไบนารีที่สร้างไว้ล่วงหน้าสำหรับผู้ใช้ที่ต้องการผสานรวม Firebase โดยไม่ต้องใช้ตัวจัดการการพึ่งพา ในการติดตั้ง Firebase:
ดาวน์โหลด เฟรมเวิร์ก SDK zip ไฟล์นี้มีชิ้นส่วนสถาปัตยกรรมสำหรับสถาปัตยกรรมเป้าหมายที่มีอยู่ทั้งหมดสำหรับ Firebase SDK ทั้งหมด ดังนั้นอาจใช้เวลาสักครู่ในการดาวน์โหลด
คลายซิปไฟล์ จากนั้นตรวจสอบ
README
สำหรับเฟรมเวิร์กที่คุณต้องการรวมไว้ในแอปของคุณเพิ่ม แฟล็กตัวเชื่อมโยง
-ObjC
ในOther Linker Settings
ของคุณในการตั้งค่าการสร้างเป้าหมายของคุณ