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