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

เรากำลังรวม SDK ส่วนขยาย Swift ของเราเข้ากับ SDK หลักเพื่อให้ API แบบ Swift-native API เปิดให้ใช้งานในวงกว้างยิ่งขึ้น และเพิ่มความสามารถในการสนับสนุน ฟีเจอร์ภาษา 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 ที่ประกาศการเปลี่ยนแปลงนี้

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

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

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

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

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

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

เครื่องมือจัดการแพ็กเกจ 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 ทั้งหมดที่คุณใช้ก่อนหน้านี้ ให้ทำดังนี้ การดำเนินการ:

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