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

אנו ממזגים את ערכות ה-SDK של תוסף Swift שלנו לתוך ערכות ה-SDK הראשיות על מנת להפוך את ממשקי ה-API מקוריים של Swift לזמינים יותר ולהגביר את היכולת שלנו לתמוך בתכונות חדשות בשפת Swift בעתיד. השינויים שאנו מבצעים וההשפעות הצפויות שלהם על הפרויקטים שלך מתועדים להלן.

מה משתנה?

החל מ-Firebase for Apple SDK 10.17.0, ערכות ה-SDK של תוסף Swift מוזגו לתוך ה-SDK הראשי התואמים להם. לדוגמה, כל ממשקי ה-API ממודול FirebaseFirestoreSwift נוספו ל- FirebaseFirestore , כך שכבר אין צורך לייבא את מודול FirebaseFirestoreSwift כדי לגשת לממשקי ה-API האלה.

מכיוון שכל ההרחבות של Swift כעת הן חלק מהמודולים הראשיים, ערכות ה-SDK של ההרחבות אינן נחוצות יותר, והן הוצאו משימוש. הכללה או שימוש ב-SDKs של תוסף Swift תעלה אזהרת מהדר וכבר בפברואר 2024, נפסיק לשחרר לחלוטין את ההרחבות של Swift.

★ הערה: כל גרסאות שפורסמו כרגע או קודמות של הרחבות Swift עדיין יפעלו. עם זאת, אנו ממליצים שתעביר את האפליקציה שלך לשימוש בממשקי API של Swift מהמודול הראשי כדי להבטיח שתמשיך לקבל תיקונים ותוכל לנצל את השינויים והתכונות החדשות.

תאריכים חשובים לשינוי זה

באוקטובר 2023

ערכות ה-SDK של הרחבות של Swift מוזגו לתוך ה-SDK הראשי ולאחר מכן הוצאו משימוש לטובת ערכות ה-SDK הראשיות. עיין בהערות הגרסה עבור גרסה 10.17.0 המכריזה על שינוי זה.

כעת תוכל להשתמש בממשקי ה-API של Swift extension SDK ישירות ממודולי SDK הראשיים. השימוש ב-SDKs של התוסף עדיין אפשרי עד שחרור הגרסה העיקרית הבאה, אך יעורר אזהרת הוצאה משימוש בעת השימוש.

כבר בפברואר 2024

נפסיק לשחרר גרסאות חדשות של הרחבות Swift, ונסיר את הרחבות Swift מה- Package.swift של Firebase. גרסאות ישנות יותר ימשיכו לפעול אך לא יקבלו עדכונים.

כיצד לעבור לשימוש בממשקי API מקוריים של Swift מהמודול הראשי

אם אינך משתמש כעת ב-SDK של תוסף Swift, אין צורך בפעולה. אם אתה משתמש ב-SDK של הרחבת Swift, בצע את השינויים הבאים בפרויקט שלך.

שינויים במרחב העבודה

מנהל החבילות של Swift

לאחר עדכון Firebase לגרסה 10.17.0+, נווט לקטע מסגרות, ספריות ותוכן מוטבע בכרטיסייה כללי של הגדרות היעד שלך והסר את ה-SDK של תוסף Swift (כגון FirebaseFirestoreSwift ).

CocoaPods

לאחר עדכון Firebase לגרסה 10.17.0+, נווט אל Podfile שלך ​​והסר את השורה התואמת את התלות של הפרויקט שלך בהוספת קטע ה-frameswork עבור היעד שלך והסר את ה-SDK של הרחבת Swift (כגון pod FirebaseFirestoreSwift ). לאחר מכן, הפעל מחדש את פקודת pod install .

חלוקת מיקודים וקרתגו

לאחר עדכון 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 .