אנחנו ממזגים את ערכות ה-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 וקרתגו
אחרי שמעדכנים את Firebase לגרסה 10.17.0 ואילך, מסירים את כל התוספים של Swift
xcframeworks בפרויקט (כמו
FirebaseFirestoreSwift.xcframework).
שינויים בקוד המקור
לכל ערכות ה-SDK של תוספי Swift שהשתמשתם בהן בעבר, בצעו את הפעולות הבאות:
- מוחקים את כל הצהרות הייבוא שמתייחסות ל-SDK של התוסף ל-Swift. אם לא ייבאתם את ה-SDK הראשי בנפרד, תצטרכו להחליף את הייבוא של התוסף של Swift בייבוא של ה-SDK הראשי. כדי לעשות את זה, מחקו את
Swiftבסוף השורה. - אם השתמשתם במרחב השמות המפורש של המודול של Swift כדי להפנות לסוגי SDK של תוספי Swift, תצטרכו להחליף אותם ב-SDK הראשי המתאים. לדוגמה, צריך לשנות את השם של
FirebaseFirestoreSwift.QueryPredicateל-FirebaseFirestore.QueryPredicate.