ผู้จัดการแพ็คเกจ 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 จะเริ่มแก้ไขการขึ้นต่อกันของแพ็คเกจและดาวน์โหลดในเบื้องหลัง
ผ่าน Package.swift
หากต้องการรวม Firebase เข้ากับแพ็คเกจ Swift ผ่านรายการ 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
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 14.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
Crashlytics กำหนดให้คุณต้องอัปโหลดสัญลักษณ์การแก้ไขข้อบกพร่อง
คุณสามารถใช้ระยะการรันสคริปต์สำหรับ Xcode เพื่ออัปโหลดสัญลักษณ์การแก้ไขจุดบกพร่องหลังการสร้างได้โดยอัตโนมัติ ค้นหาสคริปต์เรียกใช้ที่นี่:
"${PODS_ROOT}/FirebaseCrashlytics/run"
คาร์เธจ
การสนับสนุนคาร์เธจอยู่ระหว่างการทดลอง ดู คำแนะนำบน GitHub เพื่อรวม Firebase ในแอปของคุณผ่าน Carthage
บูรณาการด้วยตนเอง
Firebase มีการกระจาย XCFramework ไบนารีที่สร้างไว้ล่วงหน้าสำหรับผู้ใช้ที่ต้องการผสานรวม Firebase โดยไม่ต้องใช้ตัวจัดการการพึ่งพา วิธีติดตั้ง Firebase:
ดาวน์โหลด zip เฟรมเวิร์ก SDK ไฟล์นี้มีส่วนสถาปัตยกรรมสำหรับสถาปัตยกรรมเป้าหมายที่มีอยู่ทั้งหมดสำหรับ Firebase SDK ทั้งหมด และอาจต้องใช้เวลาในการดาวน์โหลด
แตกไฟล์ จากนั้นตรวจสอบ
README
เพื่อหาเฟรมเวิร์กที่คุณต้องการรวมไว้ในแอปของคุณเพิ่ม แฟล็ก
-ObjC
linker ในOther Linker Settings
ของคุณในการตั้งค่า build ของเป้าหมาย