نحن بصدد دمج حزم تطوير البرامج (SDK) الخاصة بإضافات Swift مع حِزم SDK الرئيسية لإتاحة واجهات برمجة التطبيقات المستنِدة إلى Swift على نطاق أوسع وزيادة قدرتنا على إتاحة ميزات لغة Swift الجديدة في المستقبل. تم توثيق التغييرات التي نجريها وتأثيراتها المتوقعة على مشروعاتك أدناه.
ما هي التغييرات التي سيتم إجراؤها؟
بدءًا من الإصدار 10.17.0 من حزمة تطوير البرامج (SDK) لمنصة Firebase for Apple، تم دمج حِزم SDK الخاصة بإضافات Swift في حِزم SDK الرئيسية المقابلة لها. على سبيل المثال، تمت إضافة جميع واجهات برمجة التطبيقات
من وحدة FirebaseFirestoreSwift إلى FirebaseFirestore،
وبالتالي لن يكون عليك استيراد وحدة 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، يمكنك إجراء التغييرات التالية في مشروعك.
التغييرات في Workspace
مدير حزم Swift
بعد تحديث Firebase إلى الإصدار 10.17.0 أو الإصدارات الأحدث، انتقِل إلى قسم "أُطر العمل والمكتبات والمحتوى المضمَّن" في علامة التبويب "الإعدادات العامة" ضِمن إعدادات الاستهداف، وأزِل حزمة تطوير البرامج (SDK) الخاصة بإضافة Swift (مثل FirebaseFirestoreSwift).
CocoaPods
بعد تحديث Firebase إلى الإصدار 10.17.0 أو الإصدارات الأحدث، انتقِل إلى Podfile وأزِل
السطر المقابل لاعتماد مشروعك على قسم إضافة أُطر العمل
لاستهدافك، وأزِل حزمة SDK الخاصة بالإضافة Swift
(مثل pod FirebaseFirestoreSwift). بعد ذلك، أعِد تشغيل الأمر pod install.
توزيع برامج Zip ومدينة قرطاج
بعد تحديث Firebase إلى الإصدار 10.17.0 أو الإصدارات الأحدث، عليك إزالة أيّ من إضافات Swift
xcframeworks من ضمن مشروعك (مثل
"FirebaseFirestoreSwift.xcframework").
تغييرات رمز المصدر
بالنسبة إلى جميع حِزم SDK الخاصة بإضافات Swift التي سبق لك استخدامها، يمكنك اتّخاذ الإجراءات التالية:
- احذف أيّ عبارات استيراد تشير إلى حزمة تطوير البرامج لإضافة Swift. إذا لم يتم استيراد حزمة SDK الرئيسية بشكل منفصل، ستحتاج إلى استبدال استيراد إضافة Swift باستيراد حزمة SDK الرئيسية من خلال حذف
Swiftفي نهاية السطر. - إذا استخدمت مساحة أسماء وحدات Swift الصريحة للإشارة إلى أي من أنواع حزمة تطوير البرامج (SDK)
لإضافات Swift، ستحتاج إلى استبدالها بحزمة تطوير البرامج (SDK) الرئيسية
المقابلة. على سبيل المثال، يجب إعادة تسمية
FirebaseFirestoreSwift.QueryPredicateإلىFirebaseFirestore.QueryPredicate.