التعرف على مجموعة SDK لمنصة فيسبوك بالإصدار 13.0 والتحديثات ذات الصلة
اليوم نطرح مجموعة Facebook SDK بالإصدار 13.0 والتحديثات الإضافية لمجموعات SDK لمنصة فيسبوك. يوضِّح هذا المنشور هذه التحديثات والخطوات اللازمة التي يجب أن يتخذها المطوّرون لتجنب التعطل، حسب الاقتضاء، فيما يتعلق بدمج التطبيق (التطبيقات) مع منصتنا. إليك نظرة عامة موجزة حول بعض التحديثات المضمنة كجزء من طرح مجموعة SDK بالإصدار 13.0:
- دعم واجهة Graph API بالإصدار 13.0: ندعم الآن واجهة Graph API بالإصدار 13.0 وواجهة API التسويق بالإصدار 13.0.
- طلب الإذن المضمن لمعرف معلن Android في مجموعة Facebook SDK لنظام التشغيل Android: ستتضمن الآن مجموعة Android SDK بالإصدار 13.0 طلب إذن لمعرف معلن Android بشكل افتراضي بما يتفق مع سياسة خدمات Google Play بشأن معرفات المعلنين. سيتعين على كل المطوّرين الذين يستخدمون مجموعة Facebook SDK لنظام التشغيل Android اتخاذ إجراء قبل بدء الإنفاذ المخطط لـ Google في أبريل 2022 لتجنب انقطاع الخدمة.
- بدء سريان مطلب تضمين رمز البرنامج في مجموعة SDK: مع طرح مجموعة Facebook SDK بالإصدار 13.0، سيتعين على المطوّرين الآن تضمين رموز البرنامج في مجموعة SDK.
- بدء سريان مطلب استخدام Java 8 bytecode: نطالب المطوّرين باستخدام Java 8 bytecode لتجنب أخطاء التحويل البرمجي في التطبيق.
- إعلامات إيقاف الاستخدام: أصبحت مجموعة SDK بالإصدار 12 (بما في ذلك الإصدار 12.1 و12.2 وغير ذلك) في حالة "إيقاف الاستخدام". بدءًا من اليوم، يجب على المطوّرين بدء الترحيل إلى الإصدار 13.0 لتجنب استخدام مجموعات SDK التي تم إيقاف استخدامها للتطبيق (التطبيقات).
يُرجى العثور على مزيد من التفاصيل حول هذه التحديثات الواردة أدناه.
طرح مجموعة SDK بالإصدار 13.0
تُطرح مجموعة SDK للمنصة اليوم بالإصدار 13.0 عبر منصات Android وiOS. كجزء من هذا الإصدار، تتم إضافة مجموعة SDK لواجهة Graph API بالإصدار 13.0 وواجهة API التسويق بالإصدار 13.0 في فيسبوك. لقد أنشأنا منشور المدونة هذا لتسليط الضوء على الإعلامات الإضافية وتحديثات المنتجات والتذكيرات ذات الصلة بواجهة Graph API بالإصدار 13.0 وواجهة API التسويق بالإصدار 13.0.
التحديثات الأساسية الأخرى
فيما يلي نظرة عامة على التحديثات والتغييرات الأخرى المضمنة كجزء من مجموعة SDK بالإصدار 13.0:
تحديث مجموعة SDK: التحويل من Objective-C إلى Swift
نحن بصدد تحويل رمز مجموعة SDK من Objective-C إلى Swift بما يتوافق مع تحديث مجموعات SDK للمنصة. ويتضمن الإصدار 13.0 من مجموعة SDK العديد من التغييرات بشأن عمليات التحويل التي قد تتطلب اتخاذ إجراء من جانب المطوّرين. تشتمل هذه التغييرات على:
- تم تحويل عدد من الأنواع من Objective-C إلى Swift. وقد يحتاج المطوّرون إلى استخدام عبارات استيراد نمطية عند استخدام GamingServicesKit وأغلبية ShareKit لتجنب ظهور أخطاء التحويل البرمجي في Objective-C. في مثل هذه الحالات، سيتعين على المطوّرين استخدام @import instead of #import في ملفات Objective-C عند استخدام الرموز من هذه المجموعات. يمكن للمطوّرين أيضًا الرجوع إلى سجل التغيير للحصول على مزيد من التفاصيل حول كيفية استخدام عبارات الاستيراد النمطية.
- بالإضافة إلى ذلك، نعمل على تقليل استخدام ممارسات نوع القيمة Objective-C في ShareKit. بدءًا من الإصدار 13.0 لمجموعة SDK، لم تعد أنواع محتوى ShareKit تنفذ السلوكيات التالية: التوافق مع بروتوكول NSCopying، قابلية التجزئة والمساواة المخصصة والتوافق مع NSSecureCoding. يمكن للمطوّرين عرض سجل التغييرات لمزيد من التفاصيل.
- لقد أجرينا أيضًا المزيد من التحديثات على أنواع واجهات إعداد تقارير أحداث التطبيق، بحيث تستخدم الآن أسماء معلمات وأحداث التطبيق الرسمية. يجب على المطوّرين الذين يعملون برمز Swift أن يستخدموا المثيلين AppEvents.Name وAppEvents.ParameterName لتمثيل أسماء أحداث التطبيق وأسماء المعلمات على التوالي. يمكن للمطوّرين الذين يعملون برمز Objective-C متابعة استخدام قيم السلسلة للإشارة إلى واجهات إعداد التقارير. يمكن للمطوّرين عرض سجل التغييرات لمزيد من التفاصيل.
ترحيل مكونات ممارسة ألعاب الفيديو من ShareKit إلى GamingServicesKit:
كجزء من الإصدار 13.0 من مجموعة SDK، لقد قمنا بترحيل ستة أنواع عامة لمكون ممارسة ألعاب الفيديو من ShareKit إلى GamingServicesKit وتم تحويل هذه الأنواع العامة من Objective-C إلى Swift. الأنواع العامة الستة التي تم ترحيلها هي: GameRequestActionType وGameRequestContent وGameRequestDialog وGameRequestDialogDelegate وGameRequestFilter وGameRequestURLProvider.
عمليات إيقاف الاستخدام والتغييرات العاجلة:
طلب الإذن المضمَّن لمعرف معلن Android في مجموعة Facebook SDK لنظام التشغيل Android:
يتضمن الإصدار 13.0 من مجموعة Android SDK الآن طلب إذن معرف معلن Android بشكل افتراضي. نقوم بإجراء هذا التغيير بما يتوافق مع سياسة خدمات Google Play بشأن معرفات المعلن. ندعو المطوّرين إلى اتخاذ الإجراءات الواردة أدناه قبل حلول أبريل 2022 لتجنب انقطاع الخدمة في التطبيق:
- يجب على كل المطوّرين الذين يستخدمون الإصدار 12.1 من مجموعة Android SDK والإصدارات الأحدث الترقية إلى الإصدار 13.0
- يجب على المطوّرين الذين يستخدمون أحداث التطبيق اتخاذ الخطوات التالية:
- في حالة استخدام الإصدار 12.1 أو الإصدارات الأقدم - يلزم الترقية إلى الإصدار 13.0
- في حالة استخدام الإصدار 12.2 أو 12.3 - قم بتضمين طلب إذن معرف معلن Android في ملف بيانات التطبيق لتلقي معرف معلن صالح (معرفة المزيد هنا)
- في حالة استخدام الإصدار 13.0 والإصدارات الأحدث - لا يلزم اتخاذ أي إجراء، حيث سيتم تضمين طلب إذن معرف معلن Android بشكل افتراضي
- يجب على المطوّرين الذين لا يستخدمون أحداث التطبيق اتخاذ الخطوات التالية:
بدء سريان مطلب تضمين رموز البرنامج في مجموعة SDK:
بدءًا من الإصدار 13.0 من مجموعة SDK للمنصة، يتعين على المطوّرين تضمين رمز برنامج في مجموعة SDK لاستدعاءات واجهة Graph API. ويتيح لنا تضمين رموز البرنامج في مجموعة SDK تحليل مشاكل المنصة بشكل أكثر فعالية وتحسين أداء المنصة بصفة عامة. بالتزامن مع طرح الإصدار 13.0 من مجموعة SDK للمنصة، سنستخدم الآن رموز البرنامج لمعالجة عمليات استدعاء واجهة Graph API عندما يكون رمز الوصول أو المصادقة غير متوفر. ونتيجةً لذلك، فإن أي تطبيقات تستخدم الإصدار 13.0 من مجموعة SDK والإصدارات الأحدث ولا تتضمن رمز برنامج ستعرض استثناءً عند تهيئة مجموعة SDK. يمكن للمطوّرين معرفة المزيد حول كيفية تضمين رمز برنامج التطبيق في مجموعة Android SDK هنا وفي مجموعة iOS SDK هنا لتجنب أي انقطاع في الخدمة.
بدء سريان مطلب استخدام Java 8 bytecode:
تماشيًا مع إعلام بأن أداة التحويل البرمجي في Kotlin/JVM ستنشئ Java 8 bytecode بشكل افتراضي، ونطلب الآن من المطوّرين الذين يستخدمون Facebook SDK لنظام Android الترقية إلى Java 8 bytecode لتجنب ظهور أي مشكلات أثناء التحويل البرمجي في التطبيق. يمكن للمطوّرين معرفة المزيد حول الترقية إلى Java 8 bytecode هنا.
إيقاف استخدام مجموعة SDK للمنصة بالإصدار 12.0:
بالتزامن مع طرح الإصدار 13.0 من مجموعة SDK، نعلن أن الإصدار 12.0 من مجموعة SDK سيكون الآن في حالة إيقاف استخدام لمدة عامين. وأثناء فترة إيقاف الاستخدام هذه، لن يتوفر أي دعم رسمي للصيانة بالنسبة لأي مشكلات حدثت على الإصدار 12.0 من مجموعة SDK. وفي نهاية فترة إيقاف الاستخدام التي تبلغ عامين، سيتم إيقاف عمل الإصدار 12.0 من مجموعة SDK ولن يعمل بعد الآن. بالتزامن مع إيقاف استخدام الإصدار 12.0 من مجموعة SDK، يتم تشجيع المطوّرين لبدء عملية الترحيل إلى الإصدار 13.0 من مجموعة SDK في أقرب وقت ممكن لاستخدام أحدث وأكبر مجموعة SDK مع دعم الصيانة الرسمي.
عمليات إيقاف الاستخدام للإصدار:
فيما يلي الإصدارات التي تم إيقاف استخدامها لمجموعات SDK لمنصة فيسبوك والتواريخ المرتبطة بها:
- 24 فبراير 2022: الإصدار 12 من مجموعة Android SDK وiOS SDK (تم إيقاف الاستخدام)
- 21 أكتوبر 2021: الإصدار 11 من مجموعة Android SDK وiOS SDK (تم إيقاف الاستخدام)
- 8 يونيو 2021: الإصدار 9 من مجموعة Android SDK وiOS SDK وUnity SDK (تم إيقاف الاستخدام)
- 19 يناير 2021: الإصدار 8.2 من مجموعة Android SDK وiOS SDK وUnity SDK والإصدارات الأقدم (تم إيقاف الاستخدام)
سجل التغييرات:
تفضل بزيارة سجلات التغييرات التي نوفرها لمراجعة التغييرات المحددة التي تم إجراؤها على مجموعات SDK والبقاء على اطلاع على التحسينات المخطط لها:
