نحن بصدد دمج حِزم SDK لإضافات Swift في حِزم SDK الرئيسية من أجل إتاحة واجهات برمجة التطبيقات الأصلية بلغة Swift على نطاق أوسع وتعزيز قدرتنا على توفير الدعم لميزات لغة Swift الجديدة في المستقبل. في ما يلي التغييرات التي نجريها وتأثيراتها المتوقّعة على مشاريعك.
ما هي التغييرات التي سيتمّ إجراؤها؟
بدءًا من الإصدار 10.17.0 من Firebase for Apple SDK، تم دمج حِزم SDK لإضافات Swift في حِزم SDK الرئيسية المقابلة لها. على سبيل المثال، تمت إضافة جميع واجهات برمجة التطبيقات
من الوحدة FirebaseFirestoreSwift إلى FirebaseFirestore،
لذا لم يعُد عليك استيراد الو0/} للوصول إلى
واجهات برمجة التطبيقات هذه.FirebaseFirestoreSwift
بما أنّ جميع إضافات Swift أصبحت الآن جزءًا من الوحدات الرئيسية، لم تعُد حِزم SDK للإضافات مطلوبة، وتم إيقافها نهائيًا. سيؤدي تضمين حِزم SDK لإضافات Swift أو استخدامها إلى ظهور تحذير من المحول البرمجي، واعتبارًا من فبراير 2024، سنتوقّف عن إصدار إضافات Swift بالكامل.
★ ملاحظة: ستظل أي إصدارات حالية أو سابقة من إضافات Swift تعمل. ومع ذلك، ننصحك بنقل بيانات تطبيقك لاستخدام واجهات برمجة تطبيقات Swift من الوحدة الرئيسية لضمان استمرار تلقّي الإصلاحات والاستفادة من التغييرات والميزات الجديدة.
التواريخ المهمة لهذا التغيير
في أكتوبر 2023
تم دمج حِزم SDK لإضافات Swift في حِزم SDK الرئيسية ثم تم إيقافها نهائيًا لصالح حِزم SDK الرئيسية. يمكنك الاطّلاع على ملاحظات الإصدار 10.17.0 التي تعلن عن هذا التغيير.
يمكنك الآن استخدام واجهات برمجة التطبيقات لحِزم SDK لإضافات Swift مباشرةً من وحدات حزمة SDK الرئيسية. سيظل من الممكن استخدام حِزم SDK للإضافات حتى إصدار رقم الإصدار الرئيسي التالي، ولكن سيظهر تحذير بشأن الإيقاف النهائي عند استخدامها.
اعتبارًا من فبراير 2024
سنتوقّف عن إصدار إصدارات جديدة من إضافات Swift، وسنزيل إضافات Swift من Package.swift في Firebase. ستظل الإصدارات القديمة تعمل ولكن لن تتلقّى أي تحديثات.
كيفية نقل البيانات لاستخدام واجهات برمجة التطبيقات الأصلية بلغة Swift من الوحدة الرئيسية
إذا كنت لا تستخدم حاليًا حِزم SDK لإضافات Swift، ليس عليك اتّخاذ أي إجراء. إذا كنت تستخدم حزمة SDK لإضافات Swift، عليك إجراء التغييرات التالية في مشروعك.
التغييرات في مساحة العمل
Swift Package Manager
بعد تحديث Firebase إلى الإصدار 10.17.0 أو إصدار أحدث، انتقِل إلى قسم Frameworks, Libraries, and Embedded Content (الأطر والمكتبات والمحتوى المضمّن) في علامة التبويب General (عام) لإعدادات هدفك وأزِل حزمة SDK لإضافات Swift (مثل FirebaseFirestoreSwift).
CocoaPods
بعد تحديث Firebase إلى الإصدار 10.17.0 أو إصدار أحدث، انتقِل إلى ملف Podfile وأزِل السطر الذي يتوافق مع اعتمادية مشروعك على إضافة قسم الأطر لهدفك وأزِل حزمة SDK لإضافات Swift (مثل pod FirebaseFirestoreSwift). بعد ذلك، أعِد تشغيل الأمر pod install.
Zip distribution and Carthage
بعد تحديث Firebase إلى الإصدار 10.17.0 أو إصدار أحدث، أزِل أي xcframeworks لإضافات Swift ضمن مشروعك (مثل FirebaseFirestoreSwift.xcframework).
تغييرات الرمز المصدر
بالنسبة إلى جميع حِزم SDK لإضافات Swift التي استخدمتها سابقًا، اتّخِذ الإجراءات التالية:
- احذِف أي عبارات استيراد تشير إلى حزمة SDK لإضافات Swift. إذا لم يتم استيراد حزمة SDK الرئيسية بشكل منفصل، عليك استبدال استيراد إضافة Swift باستيراد حزمة SDK الرئيسية عن طريق حذف
Swiftفي نهاية السطر. - إذا استخدمت مساحة أسماء أسماء الوحدات الصريحة في Swift للإشارة إلى أي أنواع من حزمة SDK لإضافات Swift، عليك استبدالها بحزمة SDK الرئيسية المقابلة. على سبيل المثال، يجب إعادة تسمية
FirebaseFirestoreSwift.QueryPredicateإلىFirebaseFirestore.QueryPredicate.