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