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