ما در حال ادغام SDK های افزونه Swift خود با SDK های اصلی هستیم تا API های بومی Swift را به طور گسترده تری در دسترس قرار دهیم و توانایی خود را برای پشتیبانی از ویژگی های جدید زبان Swift در آینده افزایش دهیم. تغییراتی که ما ایجاد می کنیم و تأثیرات مورد انتظار آنها بر پروژه های شما در زیر مستند شده است.
چه چیزی در حال تغییر است؟
با شروع از Firebase for Apple SDK 10.17.0، SDK های افزونه Swift در SDK های اصلی مربوطه ادغام شده اند. به عنوان مثال، تمام API های ماژول FirebaseFirestoreSwift به FirebaseFirestore اضافه شده اند، بنابراین دیگر نیازی به وارد کردن ماژول FirebaseFirestoreSwift برای دسترسی به آن API ها نیست.
از آنجایی که اکنون همه افزونه‌های سوئیفت بخشی از ماژول‌های اصلی هستند، SDKهای افزونه دیگر مورد نیاز نیستند و منسوخ شده‌اند. گنجاندن یا استفاده از SDKهای افزونه سوئیفت، هشدار کامپایلر را ایجاد می‌کند و از اوایل فوریه 2024، انتشار افزونه‌های سوئیفت را به طور کامل متوقف خواهیم کرد.
★ توجه: هر نسخه فعلی یا قبلی افزونه‌های سوئیفت همچنان کار خواهد کرد. با این حال، توصیه می‌کنیم برنامه خود را از ماژول اصلی به APIهای سوئیفت منتقل کنید تا مطمئن شوید که همچنان اصلاحات را دریافت می‌کنید و می‌توانید از تغییرات و ویژگی‌های جدید بهره‌مند شوید.
تاریخ‌های مهم برای این تغییر
در اکتبر ۲۰۲۳
SDK های افزونه Swift در SDK های اصلی ادغام شده و سپس به نفع SDK های اصلی منسوخ شده اند. برای اطلاع از این تغییر، به یادداشت های انتشار نسخه 10.17.0 مراجعه کنید.
اکنون می‌توانید از APIهای SDK افزونه Swift مستقیماً از ماژول‌های SDK اصلی استفاده کنید. استفاده از SDKهای افزونه تا انتشار نسخه اصلی بعدی همچنان امکان‌پذیر خواهد بود، اما در صورت استفاده، هشدار منسوخ شدن را نشان می‌دهد.
از اوایل فوریه ۲۰۲۴
ما انتشار نسخه‌های جدید افزونه‌های Swift را متوقف خواهیم کرد و افزونه‌های Swift را از Package.swift فایربیس حذف خواهیم کرد. نسخه‌های قدیمی‌تر به کار خود ادامه خواهند داد اما به‌روزرسانی دریافت نخواهند کرد.
نحوه مهاجرت به استفاده از APIهای بومی Swift از ماژول اصلی
اگر در حال حاضر از SDK های افزونه Swift استفاده نمی‌کنید، نیازی به انجام کاری نیست. اگر از SDK افزونه Swift استفاده می‌کنید، تغییرات زیر را در پروژه خود اعمال کنید.
تغییرات فضای کاری
مدیر بسته سوئیفت
پس از به‌روزرسانی فایربیس به نسخه ۱۰.۱۷.۰+، در تنظیمات دستگاه هدف خود، به بخش «چارچوب‌ها، کتابخانه‌ها و محتوای جاسازی‌شده» در برگه «عمومی» بروید و SDK افزونه سوئیفت (مانند FirebaseFirestoreSwift ) را حذف کنید.
کوکوپادز
پس از به‌روزرسانی فایربیس به نسخه ۱۰.۱۷.۰+، به Podfile خود بروید و خط مربوط به وابستگی پروژه خود به بخش افزودن چارچوب‌ها را برای هدف خود حذف کنید و SDK افزونه Swift (مانند pod FirebaseFirestoreSwift ) را نیز حذف کنید. سپس، دستور pod install را دوباره اجرا کنید.
توزیع پستی و کارتاژ
پس از به‌روزرسانی فایربیس به نسخه ۱۰.۱۷.۰+، هرگونه افزونه سوئیفت xcframeworks در پروژه خود حذف کنید (مانند FirebaseFirestoreSwift.xcframework ).
تغییرات کد منبع
برای تمام SDK های افزونه Swift که قبلاً استفاده کرده‌اید، اقدامات زیر را انجام دهید:
- هرگونه دستور import که به SDK افزونه Swift ارجاع می‌دهد را حذف کنید. اگر SDK اصلی جداگانه وارد نشده باشد، باید با حذف
Swiftاز انتهای خط، import افزونه Swift را با import SDK اصلی جایگزین کنید. - اگر از فضای نام explicit-module سوئیفت برای ارجاع به هر نوع SDK افزونه سوئیفت استفاده کرده‌اید، باید آنها را با SDK اصلی مربوطه جایگزین کنید. برای مثال،
FirebaseFirestoreSwift.QueryPredicateباید بهFirebaseFirestore.QueryPredicateتغییر نام دهد.