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

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

สิ่งที่จะเปลี่ยนแปลงไป

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

เนื่องจากตอนนี้ส่วนขยาย Swift ทั้งหมดเป็นส่วนหนึ่งของโมดูลหลักแล้ว จึงไม่จำเป็นต้องใช้ 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 เวอร์ชันเก่าจะยังใช้งานได้ แต่จะไม่ได้รับการอัปเดต

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

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

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

เครื่องมือจัดการแพ็กเกจ Swift

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

CocoaPods

หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0 ขึ้นไป ให้ไปที่ Podfile และนำบรรทัดที่เกี่ยวข้องกับการพึ่งพาโปรเจ็กต์ของคุณที่เพิ่มส่วนเฟรมเวิร์กสำหรับเป้าหมายและนำ SDK ส่วนขยาย Swift ออก (เช่น พ็อด 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 เหล่านั้นด้วย SDK หลักที่เกี่ยวข้อง ตัวอย่างเช่น FirebaseFirestoreSwift.QueryPredicate จะต้องเปลี่ยนชื่อเป็น FirebaseFirestore.QueryPredicate