نحن نقوم بدمج مجموعات SDK الخاصة بامتداد Swift في مجموعات SDK الرئيسية من أجل إتاحة واجهات برمجة التطبيقات الأصلية لـ Swift على نطاق أوسع وزيادة قدرتنا على دعم ميزات لغة Swift الجديدة في المستقبل. التغييرات التي نجريها وتأثيراتها المتوقعة على مشاريعك موثقة أدناه.
ما الذي يتغير؟
بدءًا من Firebase for Apple SDK 10.17.0، تم دمج حزم SDK الخاصة بامتداد Swift في حزم SDK الرئيسية المقابلة لها. على سبيل المثال، تمت إضافة جميع واجهات برمجة التطبيقات من وحدة FirebaseFirestoreSwift إلى FirebaseFirestore ، لذلك لم تعد بحاجة إلى استيراد وحدة FirebaseFirestoreSwift للوصول إلى واجهات برمجة التطبيقات تلك.
نظرًا لأن جميع امتدادات Swift أصبحت الآن جزءًا من الوحدات الرئيسية، فإن حزم SDK الخاصة بالامتداد لم تعد مطلوبة، وتم إهمالها. سيؤدي تضمين أو استخدام حزم SDK لامتداد Swift إلى رفع تحذير للمترجم، وفي وقت مبكر من فبراير 2024، سنتوقف عن إصدار ملحقات Swift بالكامل.
★ ملاحظة: أي إصدارات تم إصدارها حاليًا أو مسبقًا من ملحقات Swift ستظل تعمل. ومع ذلك، نوصي بترحيل تطبيقك لاستخدام Swift APIs من الوحدة الرئيسية لضمان استمرار تلقي الإصلاحات والاستفادة من التغييرات والميزات الجديدة.
مواعيد مهمة لهذا التغيير
في أكتوبر 2023
تم دمج حزم SDK الخاصة بامتداد Swift في حزم SDK الرئيسية ثم تم إهمالها لصالح حزم SDK الرئيسية. راجع ملاحظات الإصدار الخاصة بالإصدار 10.17.0 التي تعلن عن هذا التغيير.
يمكنك الآن استخدام Swift Extension SDK APIs مباشرةً من وحدات SDK الرئيسية. سيظل استخدام حزم SDK الملحقة ممكنًا حتى إصدار الإصدار الرئيسي التالي ولكنه سيثير تحذيرًا بالإهمال عند استخدامه.
في وقت مبكر من فبراير 2024
سنتوقف عن إصدار إصدارات جديدة من ملحقات Swift، وسنقوم بإزالة امتدادات Swift من Package.swift الخاص بـ Firebase. ستستمر الإصدارات الأقدم في العمل ولكنها لن تتلقى التحديثات.
كيفية الترحيل لاستخدام واجهات برمجة التطبيقات Swift-native من الوحدة الرئيسية
إذا كنت لا تستخدم حاليًا حزم SDK الخاصة بامتداد Swift، فلا يلزم اتخاذ أي إجراء. إذا كنت تستخدم Swift Extension SDK، فقم بإجراء التغييرات التالية في مشروعك.
تغييرات مساحة العمل
مدير الحزم سويفت
بعد تحديث Firebase إلى الإصدار 10.17.0+، انتقل إلى قسم إطارات العمل والمكتبات والمحتوى المضمن في علامة التبويب "عام" في إعدادات هدفك وقم بإزالة ملحق Swift SDK (مثل FirebaseFirestoreSwift ).
كاكاوبودس
بعد تحديث Firebase إلى الإصدار 10.17.0+، انتقل إلى Podfile الخاص بك وأزل السطر المطابق لاعتماد مشروعك على إضافة قسم الأطر لهدفك وقم بإزالة ملحق Swift SDK (مثل pod FirebaseFirestoreSwift ). ثم أعد تشغيل أمر pod install .
توزيع الرمز البريدي وقرطاج
بعد تحديث Firebase إلى الإصدار 10.17.0+، قم بإزالة أي ملحق Swift xcframeworks داخل مشروعك (مثل FirebaseFirestoreSwift.xcframework ).
تغييرات كود المصدر
بالنسبة لجميع حزم SDK الخاصة بامتداد Swift التي استخدمتها مسبقًا، قم باتخاذ الإجراءات التالية:
- احذف أي بيانات استيراد تشير إلى ملحق Swift SDK. إذا لم يتم استيراد SDK الرئيسي بشكل منفصل، فستحتاج إلى استبدال استيراد ملحق Swift باستيراد SDK الرئيسي عن طريق حذف
Swiftفي نهاية السطر. - إذا استخدمت مسافة اسم الوحدة الصريحة الخاصة بـ Swift للإشارة إلى أي أنواع SDK لامتداد Swift، فستحتاج إلى استبدال تلك الأنواع بحزمة SDK الرئيسية المقابلة. على سبيل المثال، يجب إعادة تسمية
FirebaseFirestoreSwift.QueryPredicateإلىFirebaseFirestore.QueryPredicate.