ย้ายข้อมูลไปใช้ 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 จะทำให้เกิดคำเตือนคอมไพเลอร์ และตั้งแต่เดือนกุมภาพันธ์ 2024 เป็นต้นไป เราจะหยุดเผยแพร่ส่วนขยาย Swift โดยสิ้นเชิง

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

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

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

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

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

เร็วที่สุดคือเดือนกุมภาพันธ์ 2024

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

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

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

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

Swift Package Manager

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

CocoaPods

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

การแจกแจงรหัสไปรษณีย์และ 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