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