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