ما در حال ادغام SDK های برنامه افزودنی Swift خود با SDK های اصلی هستیم تا API های بومی Swift را به طور گسترده در دسترس قرار دهیم و توانایی خود را برای پشتیبانی از ویژگی های زبان جدید Swift در آینده افزایش دهیم. تغییراتی که ما ایجاد می کنیم و تأثیرات مورد انتظار آنها بر پروژه های شما در زیر مستند شده است.
چه چیزی در حال تغییر است؟
با شروع Firebase برای Apple SDK 10.17.0، SDK های افزونه Swift در SDK های اصلی متناظر خود ادغام شدند. برای مثال، همه APIهای ماژول FirebaseFirestoreSwift به FirebaseFirestore اضافه شده‌اند، بنابراین دیگر لازم نیست ماژول FirebaseFirestoreSwift را برای دسترسی به آن APIها وارد کنید.
از آنجایی که همه برنامه‌های افزودنی سوئیفت اکنون بخشی از ماژول‌های اصلی هستند، SDKهای افزونه دیگر مورد نیاز نیستند و منسوخ شده‌اند. گنجاندن یا استفاده از SDK های افزودنی سوئیفت، یک هشدار کامپایلر ایجاد می کند و از فوریه 2024، انتشار برنامه های افزودنی سوئیفت را به طور کامل متوقف خواهیم کرد.
★ توجه: هر نسخه فعلی یا قبلی منتشر شده از برنامه های افزودنی سوئیفت همچنان کار خواهد کرد. با این حال، توصیه می‌کنیم برنامه خود را برای استفاده از APIهای Swift از ماژول اصلی منتقل کنید تا مطمئن شوید که همچنان به دریافت اصلاحات ادامه می‌دهید و می‌توانید از تغییرات و ویژگی‌های جدید بهره ببرید.
تاریخ های مهم برای این تغییر
در اکتبر 2023
SDK های برنامه افزودنی سوئیفت در SDK های اصلی ادغام شده اند و سپس به نفع SDK های اصلی منسوخ شده اند. به یادداشت های انتشار نسخه 10.17.0 که این تغییر را اعلام می کند، مراجعه کنید.
اکنون می‌توانید از میان‌افزارهای SDK پسوند سوئیفت مستقیماً از ماژول‌های اصلی SDK استفاده کنید. استفاده از SDK های برنامه افزودنی هنوز تا نسخه اصلی بعدی امکان پذیر است، اما در صورت استفاده، یک اخطار منسوخ شدن ایجاد می کند.
در اوایل فوریه 2024
ما انتشار نسخه‌های جدید برنامه‌های افزودنی Swift را متوقف می‌کنیم و افزونه‌های Swift را از Firebase's Package.swift حذف می‌کنیم. نسخه های قدیمی تر به کار خود ادامه می دهند اما به روز رسانی دریافت نمی کنند.
نحوه مهاجرت به استفاده از APIهای بومی سوئیفت از ماژول اصلی
اگر در حال حاضر از SDK های برنامه افزودنی سوئیفت استفاده نمی کنید، هیچ اقدامی لازم نیست. اگر از SDK افزونه Swift استفاده می کنید، تغییرات زیر را در پروژه خود اعمال کنید.
فضای کاری تغییر می کند
مدیر بسته سوئیفت
پس از به‌روزرسانی Firebase به نسخه 10.17.0+، به بخش Frameworks, Libraries, and Embedded Content در برگه عمومی تنظیمات هدف خود بروید و SDK افزونه Swift (مانند FirebaseFirestoreSwift ) را حذف کنید.
CocoaPods
پس از به‌روزرسانی Firebase به نسخه 10.17.0+، به Podfile خود بروید و خط مربوط به وابستگی پروژه خود به افزودن بخش چارچوب برای هدف خود را حذف کنید و SDK افزونه Swift (مانند pod FirebaseFirestoreSwift ) را حذف کنید. سپس دستور pod install دوباره اجرا کنید.
توزیع زیپ و کارتاژ
پس از به‌روزرسانی Firebase به نسخه 10.17.0+، هر xcframeworks افزونه Swift را در پروژه خود حذف کنید (مانند FirebaseFirestoreSwift.xcframework ).
کد منبع تغییر می کند
برای همه SDK های برنامه افزودنی Swift که قبلاً استفاده کرده اید، اقدامات زیر را انجام دهید:
- هر گونه عبارت وارداتی را که به SDK برنامه افزودنی Swift ارجاع می دهد حذف کنید. اگر SDK اصلی به طور جداگانه وارد نشده است، باید با حذف
Swiftدر انتهای خط، واردات افزونه Swift را با واردات SDK اصلی جایگزین کنید. - اگر از فضای نام ماژول صریح Swift برای ارجاع به انواع SDK افزونه Swift استفاده کرده‌اید، باید آنها را با SDK اصلی مربوطه جایگزین کنید. برای مثال،
FirebaseFirestoreSwift.QueryPredicateباید بهFirebaseFirestore.QueryPredicateتغییر نام دهد.