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

ونعمل على دمج حزم تطوير البرامج (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 التي سبق لك استخدامها، اتّبِع الخطوات التالية: الإجراءات:

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