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

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

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

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

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

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

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

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

  • اعتبارًا من سبتمبر 2026، لم تعُد واجهة برمجة التطبيقات تسجيل الدخول باستخدام حساب Google لنظام Android متوافقة.

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

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

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

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

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

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

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

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

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