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

במסמך הזה מפורט לוח הזמנים להוצאה משימוש של גרסה 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. חשוב לעבור לגרסה 2 של Play Games Services בהתאם לפתרון שמופיע כאן, מיד אחרי שהפתרון יושק לקראת סוף הרבעון השני של 2026.
יוני 2026 הסרות של ממשקי API בגרסה 1 של Play Games Services פורסם 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, play-services-auth לא מספקת יותר GSI.
  3. בהתאם ללוח הזמנים שצוין בקטע הקודם, מפתחי משחקים יכולים לשדרג ערכות SDK אחרות ולדאוג שערכות SDK אחרות לא ישתמשו ב-Credential Manager SDK החדש עד שהן יועברו ל-Play Games Services בגרסה 2.
מאי 2027 השבתה של גרסה 1 של Play Games Services כל התנועה מגרסה 1 של Play Games Services נחסמת ללא קומפילציה של משחק.

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

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

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

  • החל מספטמבר 2026, אין יותר תמיכה ב-Google Sign-In for Android API.

  • החל מיוני 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
הסרת API של גרסה 1 של Play Games Services מה-SDK.		 מעבר לגרסה 2(Java או Kotlin)

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

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

יכול להיות שתצטרכו לעדכן את 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. לא ידוע על הסרת ממשקי GSI API, שדרוג המשחק לגרסה האחרונה של 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. מחזירים את גרסת ה-SDK של SDK1.
  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.