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