الجدول الزمني للإيقاف النهائي

يوضّح هذا المستند الجدول الزمني لإيقاف الإصدار 1 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play" نهائيًا.

بعد إيقاف واجهة برمجة التطبيقات تسجيل الدخول بحساب Google نهائيًا والإيقاف المُخطَّط له، سنوقف نهائيًا الإصدار v1 من حزمة تطوير البرامج (SDK) وواجهات برمجة التطبيقات الخاصة بـ "خدمات ألعاب Play". يجب نقل لعبتك إلى الإصدار 2 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play" للاستفادة من أحدث الميزات.

في ما يلي المخططات الزمنية لإيقاف الميزات نهائيًا:

التاريخ مَعْلَم
الإيقاف النهائي
التأثير إجراء
المطوّر
مايو 2026 إزالة واجهة برمجة التطبيقات GSI إذا أضافت إحدى الألعاب ميزات جديدة، مثل عمليات التشغيل المباشر أو المهام أو الخرائط، لا تعتمد على مصادقة Google باستثناء واجهة برمجة التطبيقات الإصدار 1 من "خدمات ألعاب Play"، ستستمر هذه الميزات في العمل.

إذا كانت لعبتك تستخدم حزمة SDK تابعة لجهة خارجية أو حزمة SDK من Google غير الإصدار 1 من "خدمات ألعاب Play" وتتطلّب ترقية المصادقة، قد تؤدي الترقية إلى أحدث إصدار من حزمة SDK هذه إلى حدوث أخطاء في التجميع.
  1. اتّبِع مسار الحلّ المذكور هنا عند مواجهة خطأ في التجميع.
  2. احرص على نقل البيانات إلى الإصدار 2 من "خدمات ألعاب Play" وفقًا لمسار الحل المذكور هنا بعد طرح الحل مباشرةً في نهاية الربع الثاني من عام 2026.
‫15 يونيو 2026 إزالة واجهات برمجة التطبيقات في الإصدار 1 من "خدمات ألعاب Play" سيتم نشر حزمة تطوير البرامج (SDK) الجديدة للإصدار 1 من "خدمات ألعاب Play" مع إزالة واجهات برمجة التطبيقات الخاصة بـ "خدمة تسجيل الدخول باستخدام حساب Google"، ولن يتم إجراء أي إصلاحات أخرى للأخطاء أو تحديثات لميزات الإصدار 1 الحالية من "خدمات ألعاب Play".
إذا تمت ترقية تطبيق حالي يستخدم الإصدار 1 إلى أحدث إصدار من "خدمات ألعاب Play"، ستتوقف وظائف "خدمات ألعاب Play" في هذا الإصدار الجديد عن العمل.
  1. يجب ألا تُرقّي الألعاب على الإصدار 1 من "خدمات ألعاب Play" حزمة تطوير البرامج (SDK) للإصدار 1 إلى com.google.android.gms:play-services-games:25.0.0، ما يؤدي إلى إزالة واجهات برمجة التطبيقات للإصدار 1.
  2. قد تحدث أخطاء في التجميع في أي لعبة لم يتم نقل بياناتها إلى الإصدار 2 من "خدمات ألعاب Play" لأنّ play-services-auth لن توفّر GSI اعتبارًا من مايو 2026.
  3. وفقًا للجدول الزمني المذكور في القسم السابق، يمكن للألعاب الحفاظ على اليقظة بشأن ترقية حِزم SDK الأخرى والتأكّد من أنّ حِزم SDK الأخرى لا تستخدم حزمة SDK الجديدة الخاصة بـ "مدير بيانات الاعتماد" إلى أن يتم نقلها إلى الإصدار الثاني من "خدمات ألعاب Play".
مايو 2027 إيقاف الإصدار الأول من "خدمات ألعاب Play" تم حظر جميع الزيارات من الإصدار 1 من "خدمات ألعاب Play" بدون تجميع أي لعبة.

تتوقف واجهات برمجة التطبيقات الحالية للإصدار 1 من "خدمات ألعاب Play" عن العمل في بيئة الإنتاج.
والخيار الوحيد المتاح هو نقل البيانات إلى الإصدار 2 من "خدمات ألعاب Play" قبل هذا الموعد النهائي لتجنُّب حدوث انقطاع في عملية إعداد اللاعبين وتسجيل الدخول.
  • بعد سبتمبر 2025، سيتم إيقاف الإصدار v1 من حزمة تطوير البرامج (SDK) وواجهات برمجة التطبيقات للألعاب نهائيًا، ولكن ستستمر الألعاب الحالية التي تتكامل مع الإصدار v1 في العمل، وسيمنع Google Play نشر ألعاب جديدة تستخدم الإصدار v1 من حزمة SDK وواجهات برمجة التطبيقات.

  • واعتبارًا من 15 يونيو 2026، ستتم إزالة واجهات برمجة التطبيقات المتوقّفة نهائيًا من حزمة SDK.

  • اعتبارًا من يونيو 2027، ستتم إزالة الإصدار v1 من حزمة تطوير البرامج (SDK) للألعاب، ولن يتم تنفيذ أي طلبات إلى واجهات برمجة التطبيقات هذه، حتى إذا كنت تستخدم إصدارات سابقة من حزمة SDK.

يسرد الجدول التالي إصدارات الإصدار 1 من "خدمات ألعاب Play" (حزمة SDK) وتواريخ إيقافها نهائيًا وأدلة نقل البيانات:

إصدار حزمة تطوير البرامج (SDK) تاريخ الإصدار دليل نقل البيانات
play-services-games:v24.0.0 ‫12 سبتمبر 2025
متوقّف نهائيًا
نقل البيانات إلى الإصدار 2(Java أو Kotlin)
الإصدار 0.10.15 من Unity ‫17 سبتمبر 2025
تم الإيقاف نهائيًا
نقل البيانات إلى الإصدار 2(Unity)
play-services-games:v25.0.0 ‫15 يونيو 2026
إزالة الإصدار 1 من واجهة برمجة التطبيقات الخاصة بـ "خدمات ألعاب Play" من حزمة تطوير البرامج (SDK)
نقل البيانات إلى الإصدار 2(Java أو Kotlin)

مثال على تأثير إزالة واجهة برمجة التطبيقات GSI

لنفترض أنّ حزمة SDK، وهي SDK1، تسترجع قائمة بالأصدقاء من حساب أحد اللاعبين على Google. لاستخدام هذه الميزة، يجب أن يصادق اللاعبون على حساب Google الخاص بهم باستخدام حزمة تطوير البرامج (SDK) الخاصة بمصادقة Google.

قد تحتاج إلى تعديل حزمة تطوير البرامج (SDK) الخاصة بخدمة "مصادقة Google" في الحالات التالية:

  • حلّ خطأ فادح في عملية المصادقة
  • تطبيق تجارب مفاتيح المرور الجديدة التي توفّرها حزمة تطوير البرامج (SDK) الخاصة بأداة "إدارة بيانات الاعتماد"

يوضّح الجدول التالي السيناريوهات الثلاثة لتعديل عملية دمج المصادقة في لعبتك:

  • السيناريو 1: تتم ترقية SDK1 إلى أحدث إصدار من حزمة تطوير البرامج (SDK) الخاصة بخدمة "المصادقة من Google".
  • السيناريو 2: تتكامل حزمة SDK1 مع "مدير بيانات الاعتماد"، مع عدم تغيير حزمة SDK الخاصة بخدمة "المصادقة من Google".
  • السيناريو 3: تتكامل حزمة SDK1 مع "إدارة بيانات الاعتماد" وتزيل حزمة Google Authentication SDK.
الميزة السيناريو 1 السيناريو 2 السيناريو 3
سيناريوهات ترقية المصادقة
  1. لم يكن على علم بإزالة واجهات برمجة التطبيقات في "خدمة تسجيل الدخول باستخدام Google"، وتمت ترقية اللعبة إلى أحدث حزمة SDK للمصادقة.
  2. تتوقّف وظيفة المصادقة الحالية، ويتم فرض دمج حزمة تطوير البرامج (SDK) الخاصة بـ Credential Manager مع SDK1.
  3. تطرح اللعبة أحدث إصدار يتضمّن أحدث حزمة SDK للمصادقة وحزمة SDK لـ "إدارة بيانات الاعتماد".
مع العلم بإزالة واجهة برمجة التطبيقات GSI، لا ترقّي حزمة SDK1 حزمة SDK للمصادقة، ولكنها تتيح وظيفة المصادقة من Google باستخدام حزمة Credential Manager SDK في أحدث إصدار لها. في أحدث إصدار، تتيح حزمة SDK1 وظيفة المصادقة من Google باستخدام حزمة Credential Manager SDK وتزيل حزمة SDK للمصادقة بالكامل.
حزمة تطوير البرامج (SDK) للإصدار 1 من "خدمات ألعاب Play" بلا تغيير بلا تغيير بلا تغيير
ماذا يحدث عند تجميع اللعبة؟
  1. يتطلّب الإصدار 1 من "خدمات ألعاب Play" دمج حزمة تطوير البرامج (SDK) الخاصة بالمصادقة بشكل منفصل -> بما أنّه تمّت ترقية حزمة تطوير البرامج (SDK) الخاصة بالمصادقة بدون واجهات برمجة تطبيقات GSI، سيتوقّف الإصدار 1 من "خدمات ألعاب Play" عن العمل.
  2. تظهر أخطاء في وقت الترجمة في اللعبة.
  3. بعد ذلك، تحاول اللعبة اتّباع مسار الحل.
حدوث أخطاء في وقت تجميع اللعبة بعد ذلك، تحاول اللعبة اتّباع مسار الحل.
تجربة اللاعب المحتملة لا ينطبق. بما أنّ اللعبة لا يمكن تجميعها، لن يتم نشرها.
  1. تظهر أداة اختيار حساب "خدمات ألعاب Play" للاعب عند المصادقة باستخدام الإصدار 1 من "خدمات ألعاب Play".
  2. تظهر ورقة Credential Manager السفلية للاعب عند المصادقة على ميزة SDK1.
  1. تظهر أداة اختيار حساب "خدمات ألعاب Play" للاعب عند المصادقة باستخدام الإصدار 1 من "خدمات ألعاب Play".
  2. تظهر ورقة Credential Manager السفلية للاعب عند المصادقة على ميزة SDK1.
مسار حلّ المشكلة لمطوّر الألعاب
  1. معرفة حزمة SDK التي تتسبّب في ترقية حزمة SDK الخاصة بالمصادقة
  2. إرجاع إصدار حزمة SDK1 إلى الإصدار السابق
  3. أعِد تجميع لعبتهم باستخدام هذه الميزة.
  4. إذا كانت ميزة اللعبة الجديدة تتطلّب الترقية إلى الإصدار 1 من حزمة تطوير البرامج (SDK)، تواصَل مع فريق الإصدار 1 من حزمة تطوير البرامج (SDK) لتبنّي السيناريو 2 أو 3 لإصدارهم.
  1. Nothing
  2. ومع ذلك، إذا كنت تستخدم أيضًا زر تسجيل الدخول باستخدام حساب Google، قد تحتاج إلى استخدام نوعَين من خطوات تسجيل الدخول باستخدام حساب Google للاعبين.
  1. Nothing
  2. ومع ذلك، إذا كنت تستخدم أيضًا زر تسجيل الدخول باستخدام حساب Google، قد تحتاج إلى استخدام نوعَين من خطوات تسجيل الدخول باستخدام حساب Google للاعبين.
النتيجة النهائية للإصدار 1 من "خدمات ألعاب Play" لا تحتاج اللعبة إلى الترقية إلى الإصدار 2 من "خدمات ألعاب Play"، ولكنّ الإصدار 1 من حزمة SDK سيظل قديمًا. لا تحتاج اللعبة إلى الترقية من الإصدار 1 إلى الإصدار 2 من "خدمات ألعاب Play". لا تحتاج اللعبة إلى الترقية من الإصدار 1 إلى الإصدار 2 من "خدمات ألعاب Play".