לוח הזמנים להוצאה משימוש

במסמך הזה מפורט לוח הזמנים להוצאה משימוש של גרסה 1 של ה-SDK של Play Games Services.

בעקבות ההוצאה משימוש של Google Sign-in (GSI) API והסגירה המתוכננת, אנחנו מוציאים משימוש את Play Games Services v1 SDK ואת ממשקי ה-API. כדי להשתמש בתכונות העדכניות ביותר, צריך להעביר את המשחק לגרסה 2 של ה-SDK של Play Games Services.

לוחות הזמנים להוצאה משימוש הם:

תאריך אבן דרך
להוצאה משימוש		 השפעה פעולה של מפתח
מאי 2026 הסרת GSI API אם למשחק נוספות תכונות חדשות, כמו הפעלות בזמן אמת, משימות או מפות, שלא מסתמכות על אימות של Google, למעט Play Games Services v1 API, התכונות האלה ימשיכו לפעול.

אם במשחק שלכם נעשה שימוש ב-SDK של צד שלישי או ב-SDK של Google שאינו גרסה 1 של Play Games Services, שנדרש בו שדרוג אימות, שדרוג לגרסה העדכנית של ה-SDK הזה עלול לגרום לשגיאות קומפילציה.
  1. אם נתקלים בשגיאת קומפילציה, צריך לפעול לפי השלבים לפתרון הבעיה שמופיעים כאן.
  2. חשוב לעבור ל-Play Games Services בגרסה 2 בהתאם לפתרון שמופיע כאן, מיד אחרי שהפתרון יושק לקראת סוף הרבעון השני של 2026.
‫15 ביוני 2026 הסרות של Play Games Services v1 API גרסה חדשה של Play Games Services v1 SDK עם ממשקי GSI API שהוסרו תפורסם ללא תיקוני באגים או עדכונים נוספים לתכונות הקיימות של Play Games Services v1.
אם משחק קיים עם גרסה 1 ישודרג לגרסה האחרונה של Play Games Services (גרסה 1), הפונקציות של Play Games Services בגרסה החדשה יפסיקו לפעול.
  1. משחקים בגרסה 1 של Play Games Services לא יכולים לשדרג את גרסה 1 של ה-SDK לגרסה com.google.android.gms:play-services-games:25.0.0, שבה מוסרים ממשקי API של גרסה 1.
  2. יכול להיות שיהיו שגיאות קומפילציה במשחקים שלא עברו לגרסה 2 של Play Games Services, כי החל ממאי 2026 לא יהיה יותר GSI ב-play-services-auth.
  3. בהתאם ללוח הזמנים שצוין בקטע הקודם, מפתחי משחקים יכולים לשדרג ערכות SDK אחרות ולדאוג שערכות SDK אחרות לא ישתמשו ב-Credential Manager SDK החדש עד שהם יעברו לגרסה 2 של Play Games Services.
מאי 2027 הפסקת התמיכה בגרסה 1 של Play Games Services כל התנועה מגרסה 1 של Play Games Services נחסמת ללא קומפילציה של משחק.

ממשקי API קיימים של Play Games Services בגרסה 1 מפסיקים לפעול בסביבת הייצור. 		האפשרות היחידה היא לעבור ל-Play Games Services מגרסה 2 לפני המועד האחרון הזה, כדי למנוע שיבושים בהצטרפות של שחקנים ובכניסה שלהם.

  • אחרי ספטמבר 2025, ה-SDK וממשקי ה-API בגרסה Games v1 יוצאו משימוש. פריטים קיימים עם גרסה 1 ימשיכו לפעול. ב-Google Play, אי אפשר לפרסם משחקים חדשים שמשתמשים בגרסה 1 של ה-SDK ובממשקי ה-API.

  • החל מ-15 ביוני 2026, ממשקי ה-API שהוצאו משימוש יוסרו מה-SDK.

  • החל מיוני 2027, ה-SDK בגרסה Games v1 יוסר. הקריאות ל-API האלה ייכשלו, גם אם אתם משתמשים בגרסאות קודמות של ה-SDK.

בטבלה הבאה מפורטות הגרסאות של משחקים בגרסה 1 (SDK), תאריכי הוצאה משימוש ומדריכי העברה:

גרסת SDK תאריך הפצה מדריך להעברת נתונים (מיגרציה)
‫play-services-games:v24.0.0 ‫12 בספטמבר 2025
הוצא משימוש		 מעבר לגרסה 2(Java או Kotlin)
‫v0.10.15 Unity ‫17 בספטמבר 2025
יצא משימוש		 מעבר לגרסה 2(Unity)
‫play-services-games:v25.0.0 ‫15 ביוני 2026
הסרת Play Games Services v1 API מה-SDK.		 מעבר לגרסה 2(Java או Kotlin)

דוגמה להשפעה של הסרת GSI API

נניח שערכת SDK‏, SDK1, מאחזרת רשימת חברים מחשבון Google של שחקן. כדי להשתמש בתכונה הזו, השחקנים צריכים לאמת את חשבון Google שלהם באמצעות Google Authentication SDK.

יכול להיות שתצטרכו לעדכן את Google Authentication SDK במצבים הבאים:

  • לפתור באג קריטי בתהליך האימות.
  • הטמעה של חוויות חדשות של מפתחות גישה שמוצעות על ידי Credential Manager SDK.

בטבלה הבאה מתוארים שלושה תרחישים לעדכון השילוב של אימות במשחק:

  • תרחיש 1: שדרוג SDK1 לגרסה העדכנית של Google Authentication SDK.
  • תרחיש 2: SDK1 משולב עם Credential Manager, ו-Google Authentication SDK נשאר ללא שינוי.
  • תרחיש 3:‏ SDK1 משתלב עם Credential Manager ומסיר את Google Authentication SDK.
תכונה תרחיש 1 תרחיש 2 תרחיש 3
תרחישי שדרוג של אימות
  1. לא מודע להסרה של ממשקי ה-API של GSI, שדרוגים של משחקים לגרסה האחרונה של SDK לאימות.
  2. פונקציונליות האימות הקיימת נשברת ומערכת SDK1 נאלצת לשלב את Credential Manager SDK.
  3. הגרסה האחרונה של המשחק כוללת את גרסת ה-SDK העדכנית ביותר לאימות ואת גרסת ה-SDK העדכנית ביותר של Credential Manager.
 ב-SDK1 מודעים להסרה של GSI API, ולכן הוא לא משדרג את ה-SDK לאימות, אלא מפעיל את פונקציית האימות של Google באמצעות Credential Manager SDK בגרסה האחרונה שלו. בגרסה האחרונה, SDK1 מפעיל את פונקציית האימות של Google באמצעות Credential Manager SDK, ומסיר לחלוטין את auth SDK.
‫Play Games Services v1 SDK ללא שינוי ללא שינוי ללא שינוי
מה קורה כשמבצעים קומפילציה של משחק
  1. בגרסה 1 של Play Games Services נדרש שילוב נפרד של Auth SDK -> מכיוון ש-Auth SDK משודרג ללא ממשקי GSI API, גרסה 1 של Play Games Services תפסיק לפעול.
  2. במשחק מתרחשות שגיאות בזמן ההידור.
  3. המשחק מנסה לפעול לפי נתיב הרזולוציה.
 המשחק מקבל שגיאות בזמן ההידור המשחק מנסה לפעול לפי נתיב הרזולוציה.
חוויית שחקן אפשרית לא רלוונטית. המשחק לא ניתן לקומפילציה ולכן לא ניתן לפרסם אותו.
  1. השחקן רואה את בורר החשבונות של Play Games Services כשהוא מאמת את עצמו באמצעות Play Games Services v1.
  2. השחקן רואה את הגיליון התחתון של Credential Manager כשהוא מבצע אימות לתכונה של SDK1.
  1. השחקן רואה את בורר החשבונות של Play Games Services כשהוא מאמת את עצמו באמצעות Play Games Services v1.
  2. השחקן רואה את הגיליון התחתון של Credential Manager כשהוא מבצע אימות לתכונה של SDK1.
נתיב לפתרון בעיות למפתחי משחקים
  1. כך בודקים איזו ערכת SDK גורמת לשדרוג של Auth SDK.
  2. החזרה לגרסת SDK1 של ה-SDK.
  3. צריך לקמפל מחדש את המשחק שלהם עם התכונה שלהם.
  4. אם התכונה החדשה במשחק דורשת שדרוג ל-SDK1, צריך לפנות ל-SDK1 כדי להטמיע את תרחיש 2 או 3 בגרסה שלו.
  1. Nothing
  2. עם זאת, אם אתם משתמשים גם בלחצן כניסה באמצעות חשבון Google, יכול להיות שתצטרכו להשתמש בשני סוגים של תהליכי כניסה לחשבון Google עבור השחקנים.
  1. Nothing
  2. עם זאת, אם אתם משתמשים גם בלחצן כניסה באמצעות חשבון Google, יכול להיות שתצטרכו להשתמש בשני סוגים של תהליכי כניסה לחשבון Google עבור השחקנים.
התוצאה הסופית של Play Games Services בגרסה 1 אין צורך לשדרג את המשחק לגרסה 2 של Play Games Services, אבל SDK1 נשאר לא עדכני. אין צורך לשדרג את המשחק מגרסה 1 לגרסה 2 של Play Games Services. אין צורך לשדרג את המשחק מגרסה 1 לגרסה 2 של Play Games Services.