מעבר לשימוש בממשקי ה-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, עליכם לבצע את השינויים הבאים בפרויקט.

שינויים ב-Workspace

מנהל חבילות SWIFT

אחרי שמעדכנים את 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.