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