เรากำลังรวม SDK ส่วนขยาย Swift เข้ากับ SDK หลักเพื่อให้ API แบบ Swift-native พร้อมใช้งานในวงกว้างมากขึ้น และเพิ่มความสามารถในการรองรับฟีเจอร์ภาษา Swift ใหม่ๆ ในอนาคต การเปลี่ยนแปลงที่เรากำลังดำเนินการและผลกระทบที่คาดว่าจะเกิดขึ้นกับโปรเจ็กต์ของคุณมีระบุไว้ด้านล่าง
สิ่งที่เปลี่ยนแปลงไป
ตั้งแต่ Firebase สำหรับ Apple SDK 10.17.0 เป็นต้นไป SDK ส่วนขยาย Swift ได้รวมเข้ากับ SDK หลักที่เกี่ยวข้องแล้ว ตัวอย่างเช่น API ทั้งหมด
จากโมดูล FirebaseFirestoreSwift ได้รับการเพิ่มลงใน FirebaseFirestore
แล้ว คุณจึงไม่ต้องนำเข้าโมดูล FirebaseFirestoreSwift เพื่อเข้าถึง
API เหล่านั้นอีกต่อไป
เนื่องจากตอนนี้ส่วนขยาย Swift ทั้งหมดเป็นส่วนหนึ่งของโมดูลหลัก จึงไม่จำเป็นต้องใช้ SDK ส่วนขยายอีกต่อไปและเลิกใช้งานแล้ว การรวมหรือใช้ SDK ส่วนขยาย Swift จะทำให้เกิดคำเตือนคอมไพเลอร์ และเราจะหยุดเผยแพร่ส่วนขยาย Swift ทั้งหมดตั้งแต่เดือนกุมภาพันธ์ 2024 เป็นต้นไป
★ หมายเหตุ: ส่วนขยาย Swift เวอร์ชันที่เผยแพร่ในปัจจุบันหรือก่อนหน้านี้จะยังคงทำงานต่อไป อย่างไรก็ตาม เราขอแนะนำให้คุณย้ายข้อมูลแอปเพื่อใช้ Swift API จากโมดูลหลักเพื่อให้คุณได้รับการแก้ไขต่อไป และใช้ประโยชน์จากการเปลี่ยนแปลงและฟีเจอร์ใหม่ๆ ได้
วันที่สำคัญสำหรับการเปลี่ยนแปลงนี้
ในเดือนตุลาคม 2023
SDK ส่วนขยาย Swift ได้รับการผสานรวมเข้ากับ SDK หลักแล้ว และเลิกใช้งานเพื่อสนับสนุน SDK หลัก ดูบันทึกประจำรุ่นสำหรับเวอร์ชัน 10.17.0 ที่ประกาศการเปลี่ยนแปลงนี้
ตอนนี้คุณสามารถใช้ Swift Extension SDK API ได้โดยตรงจากโมดูล SDK หลัก คุณจะยังใช้ SDK ส่วนขยายได้จนกว่าจะมีการเปิดตัวเวอร์ชันหลักถัดไป แต่จะมีการแจ้งเตือนการเลิกใช้งานเมื่อใช้
ตั้งแต่เดือนกุมภาพันธ์ 2024 เป็นต้นไป
เราจะหยุดเผยแพร่ส่วนขยาย Swift เวอร์ชันใหม่ และจะนำส่วนขยาย Swift ออกจาก Package.swift ของ Firebase เวอร์ชันเก่าจะยังคงทำงานต่อไปแต่จะไม่ได้รับการอัปเดต
วิธีย้ายข้อมูลเพื่อใช้ Swift-native API จากโมดูลหลัก
หากปัจจุบันคุณไม่ได้ใช้ SDK ส่วนขยาย Swift ก็ไม่จำเป็นต้องดำเนินการใดๆ หากใช้ Swift Extension SDK ให้ทำการเปลี่ยนแปลงต่อไปนี้ในโปรเจ็กต์
การเปลี่ยนแปลงพื้นที่ทำงาน
Swift Package Manager
หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0 ขึ้นไปแล้ว ให้ไปที่ส่วนเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝังในแท็บทั่วไปของการตั้งค่าเป้าหมาย แล้วนำ SDK ส่วนขยาย Swift ออก (เช่น FirebaseFirestoreSwift)
CocoaPods
หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0 ขึ้นไปแล้ว ให้ไปที่ Podfile แล้วนำบรรทัดที่สอดคล้องกับทรัพยากร Dependency ของโปรเจ็กต์ในการเพิ่มส่วนเฟรมเวิร์กสำหรับเป้าหมายออก และนำ SDK ส่วนขยาย Swift ออก (เช่น pod FirebaseFirestoreSwift) จากนั้นเรียกใช้คำสั่ง pod install อีกครั้ง
การกระจายไฟล์ ZIP และ Carthage
หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0 ขึ้นไปแล้ว ให้นำส่วนขยาย Swift xcframeworks ภายในโปรเจ็กต์ออก (เช่น FirebaseFirestoreSwift.xcframework)
การเปลี่ยนแปลงซอร์สโค้ด
สำหรับ SDK ส่วนขยาย Swift ทั้งหมดที่คุณเคยใช้ ให้ดำเนินการต่อไปนี้
- ลบคำสั่งการนำเข้าที่อ้างอิง SDK ส่วนขยาย Swift หากไม่ได้นำเข้า SDK หลักแยกต่างหาก คุณจะต้องแทนที่การนำเข้าส่วนขยาย Swift ด้วยการนำเข้า SDK หลักโดยลบ
Swiftที่ท้ายบรรทัด - หากคุณใช้เนมสเปซโมดูลที่ชัดเจนของ Swift เพื่ออ้างอิงประเภท SDK ส่วนขยาย Swift คุณจะต้องแทนที่ประเภทเหล่านั้นด้วย SDK หลักที่เกี่ยวข้อง เช่น
FirebaseFirestoreSwift.QueryPredicateจะต้องเปลี่ยนชื่อเป็นFirebaseFirestore.QueryPredicate