الانتقال إلى استخدام واجهات برمجة تطبيقات إضافة Swift في الوحدات الرئيسية

نعمل على دمج حِزم تطوير البرامج (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 وأزِل السطر المقابل لاعتماد مشروعك على إضافة القسم frameworks لهدفك وأزِل حزمة تطوير البرامج (SDK) لإضافات Swift (مثل pod FirebaseFirestoreSwift). بعد ذلك، أعِد تشغيل الأمر pod install.

توزيع Zip وCarthage

بعد تحديث Firebase إلى الإصدار 10.17.0 أو إصدار أحدث، أزِل أيّ إضافة Swift xcframeworks ضمن مشروعك (مثل FirebaseFirestoreSwift.xcframework).

تغييرات في الرمز المصدر

بالنسبة إلى جميع حِزم SDK لإضافة Swift التي استخدمتها سابقًا، عليك اتّخاذ الخطوات التالية:

1. احذِف أي عبارات استيراد تشير إلى حزمة تطوير البرامج (SDK) لإضافة Swift. إذا لم يتم استيراد حزمة SDK الرئيسية بشكل منفصل، عليك استبدال استيراد ملف التمديد Swift باستيراد حزمة SDK الرئيسية من خلال حذف Swift في نهاية السطر.
2. إذا استخدمت مساحة أسماء الوحدات الصريحة في Swift للإشارة إلى أي أنواع حِزم SDK لإضافة ميزات Swift، عليك استبدالها بحِزم SDK الرئيسية المقابلة. على سبيل المثال، يجب إعادة تسمية FirebaseFirestoreSwift.QueryPredicate إلى FirebaseFirestore.QueryPredicate.