מעבר לשימוש בממשקי ה-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.