אנחנו ממזגים את ערכות ה-SDK של התוספים של Swift עם ערכות ה-SDK הראשיות כדי להפוך את ממשקי ה-API המותאמים ל-Swift לזמינים יותר, ולהגדיל את היכולת שלנו לתמוך בתכונות חדשות של שפת Swift בעתיד. בהמשך מפורטים השינויים שאנחנו מבצעים וההשפעות הצפויות שלהם על הפרויקטים שלכם.
מה משתנה?
החל מגרסה 10.17.0 של Firebase for Apple SDK, ערכות ה-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 יש הודעה על השינוי הזה.
עכשיו אתם יכולים להשתמש בממשקי ה-API של Swift extension SDK ישירות מהמודולים הראשיים של ה-SDK. עדיין אפשר להשתמש בתוספי ה-SDK עד להשקה של הגרסה הראשית הבאה, אבל השימוש בהם יציג אזהרה על הוצאה משימוש.
החל מפברואר 2024
נפסיק להפיץ גרסאות חדשות של תוספי Swift, ונסיר את תוספי Swift מ-Package.swift של Firebase. גרסאות ישנות יותר ימשיכו לפעול אבל לא יקבלו עדכונים.
איך עוברים לשימוש בממשקי API מקוריים של Swift מהמודול הראשי
אם אתם לא משתמשים כרגע בערכות ה-SDK של תוספי Swift, אתם לא צריכים לעשות שום דבר. אם אתם משתמשים ב-Swift extension SDK, בצעו את השינויים הבאים בפרויקט.
שינויים בסביבת העבודה
Swift Package Manager
אחרי שמעדכנים את Firebase לגרסה 10.17.0 ואילך, עוברים לקטע Frameworks, Libraries, and Embedded Content בכרטיסייה General בהגדרות היעד ומסירים את ה-SDK של תוסף Swift (למשל FirebaseFirestoreSwift).
CocoaPods
אחרי שמעדכנים את Firebase לגרסה 10.17.0 ואילך, עוברים אל Podfile ומסירים את השורה שמתאימה לתלות של הפרויקט בהוספת הקטע frameworks ליעד, ומסירים את ה-SDK של התוסף של Swift (למשל pod FirebaseFirestoreSwift). לאחר מכן, מריצים מחדש את הפקודה pod install.
הפצת קובצי ZIP ו-Carthage
אחרי שמעדכנים את Firebase לגרסה 10.17.0 ואילך, מסירים את כל תוספי Swift
xcframeworks בפרויקט (כמו
FirebaseFirestoreSwift.xcframework).
שינויים בקוד המקור
בכל ערכות ה-SDK של תוספי Swift שהשתמשתם בהן בעבר, בצעו את הפעולות הבאות:
- מוחקים את כל הצהרות הייבוא שמפנות ל-SDK של תוסף Swift. אם לא ייבאתם את ה-SDK הראשי בנפרד, תצטרכו להחליף את הייבוא של התוסף של Swift בייבוא של ה-SDK הראשי. כדי לעשות את זה, מחקו את
Swiftבסוף השורה. - אם השתמשתם במרחב השמות של המודול המפורש של Swift כדי להפנות לסוגי SDK של תוספי Swift, תצטרכו להחליף אותם ב-SDK הראשי המתאים. לדוגמה, צריך לשנות את השם של
FirebaseFirestoreSwift.QueryPredicateל-FirebaseFirestore.QueryPredicate.