מעבר לשימוש בממשקי ה-API של תוסף Swift במודולים הראשיים

אנחנו ממזגים את ערכות ה-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 של ה-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 ומסירים את השורה התואמת לתלות של הפרויקט בהוספת הקטע frameworks ליעד, ומסירים את ה-SDK של התוסף ל-Swift (למשל pod FirebaseFirestoreSwift). לאחר מכן, מריצים מחדש את הפקודה pod install.

הפצת Zip ו-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.