เรากำลังรวม SDK ส่วนขยาย Swift ของเราเข้ากับ SDK หลักเพื่อให้ API แบบ Swift-native API เปิดให้ใช้งานในวงกว้างยิ่งขึ้น และเพิ่มความสามารถในการสนับสนุน ฟีเจอร์ภาษา Swift ใหม่ในอนาคต การเปลี่ยนแปลงที่เรากำลังทำและ บันทึกผลกระทบที่คาดไว้สำหรับโปรเจ็กต์ของคุณไว้ด้านล่าง
สิ่งที่จะเปลี่ยนแปลงไป
ตั้งแต่ Firebase สำหรับ Apple SDK 10.17.0 เป็นต้นไป SDK ของส่วนขยาย Swift มี
เข้ากับ SDK หลักที่เกี่ยวข้อง เช่น API ทั้งหมด
จากโมดูล FirebaseFirestoreSwift ถูกเพิ่มไปยัง FirebaseFirestore แล้ว
คุณจึงไม่ต้องนำเข้าโมดูล FirebaseFirestoreSwift เพื่อเข้าถึงอีก
API เหล่านั้น
และเนื่องจากตอนนี้ส่วนขยายของ Swift ทั้งหมดเป็นส่วนหนึ่งของโมดูลหลักแล้ว SDK ของส่วนขยาย และเลิกใช้งานแล้ว การรวมหรือใช้ Swift SDK ส่วนขยายจะเพิ่มคำเตือนของคอมไพเลอร์และโดยเร็วที่สุดในเดือนกุมภาพันธ์ 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 แล้วนำออก
บรรทัดที่สอดคล้องกับทรัพยากร Dependency ของโครงการในการเพิ่มเฟรมเวิร์ก
สำหรับเป้าหมายและนำ SDK ส่วนขยายของ Swift ออก
(เช่น พ็อด FirebaseFirestoreSwift) จากนั้นเรียกใช้คำสั่ง pod install อีกครั้ง
การแจกจ่ายรหัสไปรษณีย์และคาร์เธจ
หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0 ขึ้นไปแล้ว ให้นำส่วนขยาย Swift ทั้งหมดออก
xcframeworks ภายในโปรเจ็กต์ของคุณ (เช่น
FirebaseFirestoreSwift.xcframework)
การเปลี่ยนแปลงซอร์สโค้ด
สำหรับ SDK ส่วนขยาย Swift ทั้งหมดที่คุณใช้ก่อนหน้านี้ ให้ทำดังนี้ การดำเนินการ:
- ลบคำสั่งการนำเข้าที่อ้างอิง SDK ของส่วนขยาย Swift หาก
ไม่ได้นำเข้า SDK หลักแยกต่างหาก คุณจะต้องแทนที่ Swift
การนำเข้าส่วนขยายที่มีการนำเข้า SDK หลักโดยการลบ
Swiftที่ตำแหน่ง แค่ปลายบรรทัด - หากคุณใช้การตั้งชื่อโมดูลที่ชัดเจนของ Swift เพื่ออ้างอิงถึง Swift
ประเภท SDK ของส่วนขยาย คุณจะต้องแทนที่ประเภทเหล่านั้นด้วย
SDK ตัวอย่างเช่น
FirebaseFirestoreSwift.QueryPredicateจะต้องเป็น เปลี่ยนชื่อเป็นFirebaseFirestore.QueryPredicate