โยกย้ายไปใช้ API ส่วนขยาย Swift ในโมดูลหลัก

เรากำลังรวม SDK ส่วนขยาย Swift ของเราเข้ากับ SDK หลักเพื่อทำให้ Swift-native API พร้อมใช้งานในวงกว้างมากขึ้น และเพิ่มความสามารถของเราในการรองรับคุณสมบัติภาษา Swift ใหม่ในอนาคต การเปลี่ยนแปลงที่เรากำลังดำเนินการและผลกระทบที่คาดว่าจะมีต่อโครงการของคุณมีบันทึกไว้ด้านล่าง

มีอะไรเปลี่ยนแปลงบ้าง?

เริ่มต้นด้วย Firebase สำหรับ Apple SDK 10.17.0 SDK ส่วนขยาย Swift ได้ถูกรวมเข้ากับ SDK หลักที่เกี่ยวข้องแล้ว ตัวอย่างเช่น API ทั้งหมดจากโมดูล FirebaseFirestoreSwift ได้ถูกเพิ่มไปยัง FirebaseFirestore แล้ว ดังนั้นคุณจึงไม่จำเป็นต้องนำเข้าโมดูล FirebaseFirestoreSwift เพื่อเข้าถึง API เหล่านั้นอีกต่อไป

เนื่องจากส่วนขยาย Swift ทั้งหมดเป็นส่วนหนึ่งของโมดูลหลักแล้ว SDK ส่วนขยายจึงไม่จำเป็นอีกต่อไป และเลิกใช้งานแล้ว การรวมหรือการใช้ SDK ส่วนขยาย Swift จะทำให้เกิดคำเตือนคอมไพเลอร์ และในเดือนกุมภาพันธ์ 2024 เราจะหยุดเผยแพร่ส่วนขยาย Swift โดยสิ้นเชิง

★ หมายเหตุ: ส่วนขยาย Swift เวอร์ชันปัจจุบันหรือที่เผยแพร่ก่อนหน้านี้จะยังคงใช้งานได้ อย่างไรก็ตาม เราขอแนะนำให้คุณย้ายแอปของคุณไปใช้ Swift API จากโมดูลหลักเพื่อให้แน่ใจว่าคุณยังคงได้รับการแก้ไขต่อไปและสามารถใช้ประโยชน์จากการเปลี่ยนแปลงและคุณสมบัติใหม่ได้

วันสำคัญสำหรับการเปลี่ยนแปลงนี้

ในเดือนตุลาคม 2566

SDK ส่วนขยาย Swift ได้ถูกรวมเข้ากับ SDK หลักแล้วจึงเลิกใช้ SDK หลักแทน ดูบันทึกประจำรุ่นสำหรับเวอร์ชัน 10.17.0 ที่ประกาศการเปลี่ยนแปลงนี้

ตอนนี้คุณสามารถใช้ Swift extension SDK API ได้โดยตรงจากโมดูล SDK หลัก การใช้งาน SDK ส่วนขยายจะยังคงเป็นไปได้จนกว่าจะมีการเปิดตัวเวอร์ชันหลักถัดไป แต่จะเพิ่มคำเตือนการเลิกใช้งานเมื่อใช้

ภายในเดือนกุมภาพันธ์ 2567

เราจะหยุดปล่อยส่วนขยาย Swift เวอร์ชันใหม่ และเราจะลบส่วนขยาย Swift ออกจาก Package.swift ของ Firebase เวอร์ชันเก่าจะยังคงใช้งานได้ แต่จะไม่ได้รับการอัพเดต

วิธีโยกย้ายเพื่อใช้ Swift-native API จากโมดูลหลัก

หากปัจจุบันคุณไม่ได้ใช้ SDK ส่วนขยาย Swift ก็ไม่จำเป็นต้องดำเนินการใดๆ หากคุณใช้ SDK ส่วนขยาย Swift ให้ทำการเปลี่ยนแปลงต่อไปนี้ในโปรเจ็กต์ของคุณ

การเปลี่ยนแปลงพื้นที่ทำงาน

ผู้จัดการแพ็คเกจ Swift

หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0+ แล้ว ให้ไปที่ส่วนเฟรมเวิร์ก ไลบรารี และเนื้อหาแบบฝังในแท็บทั่วไปของการตั้งค่าเป้าหมายของคุณ และลบ SDK ส่วนขยาย Swift (เช่น FirebaseFirestoreSwift )

โกโก้พอดส์

หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0+ แล้ว ให้ไปที่ Podfile ของคุณแล้วลบบรรทัดที่เกี่ยวข้องกับการพึ่งพาโปรเจ็กต์ของคุณในการเพิ่มส่วนเฟรมเวิร์กสำหรับเป้าหมายของคุณ และลบ SDK ส่วนขยาย Swift (เช่น pod FirebaseFirestoreSwift ) จากนั้นรันคำสั่ง pod install อีกครั้ง

การกระจายซิปและคาร์เธจ

หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0+ ให้ลบส่วนขยาย Swift xcframeworks ใด ๆ ภายในโปรเจ็กต์ของคุณ (เช่น FirebaseFirestoreSwift.xcframework )

การเปลี่ยนแปลงซอร์สโค้ด

สำหรับ SDK ส่วนขยาย Swift ทั้งหมดที่คุณใช้ก่อนหน้านี้ ให้ดำเนินการต่อไปนี้:

1. ลบคำสั่งนำเข้าใดๆ ที่อ้างอิงถึง SDK ส่วนขยาย Swift หากไม่ได้นำเข้า SDK หลักแยกต่างหาก คุณจะต้องแทนที่การนำเข้าส่วนขยาย Swift ด้วยการนำเข้า SDK หลักโดยการลบ Swift ที่ท้ายบรรทัด
2. หากคุณใช้เนมสเปซโมดูลที่ชัดเจนของ Swift เพื่ออ้างอิงประเภท SDK ส่วนขยาย Swift ใด ๆ คุณจะต้องแทนที่ประเภทเหล่านั้นด้วย SDK หลักที่เกี่ยวข้อง ตัวอย่างเช่น FirebaseFirestoreSwift.QueryPredicate จะต้องเปลี่ยนชื่อเป็น FirebaseFirestore.QueryPredicate