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

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

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

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

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

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

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

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

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

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

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

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

วิธีย้ายข้อมูลไปใช้ API ที่เป็น Swift โดยเฉพาะจากโมดูลหลัก

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

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

Swift Package Manager

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

CocoaPods

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

การเผยแพร่แบบ Zip และ Carthage

หลังจากอัปเดต Firebase เป็นเวอร์ชัน 10.17.0 ขึ้นไปแล้ว ให้นำ xcframeworks ส่วนขยาย Swift ทั้งหมดภายในโปรเจ็กต์ (เช่น FirebaseFirestoreSwift.xcframework) ออก

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

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

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