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