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

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

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

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

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

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

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

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

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

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

ตั้งแต่เดือนกุมภาพันธ์ 2024

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

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

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

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

Swift Package Manager

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

CocoaPods

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

การแจกจ่าย Zip และ Carthage

หลังจากอัปเดต 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