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