Programma di ritiro

Questo documento elenca la pianificazione del ritiro dell'SDK Play Games Services v1.

A seguito del ritiro dell'API Google Sign-In (GSI) e della chiusura pianificata, ritireremo l'SDK e le API Play Games Services v1. Per usufruire delle funzionalità più recenti, devi eseguire la migrazione del gioco all'SDK Play Games Services v2.

Le tempistiche di ritiro sono le seguenti:

Data	Traguardo di ritiro	Impatto	Azione dello sviluppatore
Maggio 2026	Rimozione dell'API GSI	Se un gioco aggiunge nuove funzionalità, come liveops, missioni o mappe, che non si basano sull'autenticazione Google, ad eccezione dell'API Play Games Services v1, queste funzionalità continueranno a funzionare. Se il tuo gioco utilizza un SDK di terze parti o un SDK Google diverso da Play Games Services v1 che richiede un upgrade dell'autenticazione, l'upgrade all'ultima versione di questo SDK potrebbe causare errori di compilazione.	Segui il percorso di risoluzione indicato qui in caso di errore di compilazione. Assicurati di eseguire la migrazione a Play Games Services v2 seguendo il percorso di soluzione indicato qui subito dopo il rilascio della soluzione verso la fine del secondo trimestre del 2026.
15 giugno 2026	Rimozione dell'API Play Games Services v1	Verrà pubblicato un nuovo SDK Play Games Services v1 con le API GSI rimosse senza ulteriori correzioni di bug o aggiornamenti alle funzionalità Play Games Services v1 esistenti. Se un titolo v1 esistente esegue l'upgrade all'ultima versione di Play Games Services v1, le funzionalità di Play Games Services in questa nuova versione smetteranno di funzionare.	I giochi su Play Games Services v1 non devono eseguire l'upgrade dell'SDK v1 a com.google.android.gms:play-services-games:25.0.0, che rimuove le API v1. Qualsiasi gioco che non ha eseguito la migrazione a Play Games Services v2 potrebbe riscontrare errori di compilazione perché play-services-auth non fornisce più GSI a partire da maggio 2026. Seguendo la tempistica indicata nella sezione precedente, i giochi possono mantenere la vigilanza sull'upgrade di altri SDK e assicurarsi che altri SDK non utilizzino il nuovo SDK Gestore delle credenziali finché non viene eseguita la migrazione a Play Games Services v2.
Maggio 2027	Chiusura di Play Games Services v1	Tutto il traffico da Play Games Services v1 bloccato senza compilazione di un gioco. Le API Play Games Services v1 esistenti smettono di funzionare nell'ambiente di produzione.	L'unica opzione è eseguire la migrazione a Play Games Services v2 prima di questa scadenza per evitare interruzioni nell'onboarding e nell'accesso dei giocatori.

• Dopo settembre 2025, l'SDK e le API v1 per i giochi verranno ritirati. I titoli esistenti con le integrazioni v1 precedenti continuano a funzionare. Google Play impedisce la pubblicazione di nuovi titoli che utilizzano l'SDK e le API v1.

• A partire dal 15 giugno 2026, le API ritirate verranno rimosse dall'SDK.

• A partire da giugno 2027, l'SDK v1 per i giochi verrà rimosso. Le chiamate a queste API non andranno a buon fine, anche se utilizzi versioni precedenti dell'SDK.

La tabella seguente elenca le versioni dell'SDK v1 per i giochi, le date di ritiro e le guide alla migrazione:

Versione SDK	Data di uscita	Guida alla migrazione
play-services-games:v24.0.0	12 settembre 2025 Ritirato	Esegui la migrazione alla versione 2(Java o Kotlin)
v0.10.15 Unity	17 settembre 2025 Ritirato	Esegui la migrazione alla versione 2(Unity)
play-services-games:v25.0.0	15 giugno 2026 L'API Play Games Services v1 è stata rimossa dall'SDK.	Esegui la migrazione alla versione 2(Java o Kotlin)

Esempio di impatto della rimozione dell'API GSI

Considera uno scenario in cui un SDK, SDK1, recupera un elenco di amici dall'Account Google di un giocatore. Per utilizzare questa funzionalità, i giocatori devono autenticare il proprio Account Google utilizzando l'SDK di autenticazione Google.

Potresti dover aggiornare l'SDK di autenticazione Google nelle seguenti situazioni:

• Risolvi un bug critico nel flusso di autenticazione.
• Implementa nuove esperienze con le passkey offerte dall'SDK Gestore delle credenziali.

La tabella seguente descrive i tre scenari per l'aggiornamento dell'integrazione dell'autenticazione del gioco:

• Scenario 1: SDK1 esegue l'upgrade all'ultima versione dell'SDK di autenticazione Google.
• Scenario 2: SDK1 si integra con Gestore delle credenziali, lasciando invariato l'SDK di autenticazione Google.
• Scenario 3: SDK1 si integra con Gestore delle credenziali e rimuove l'SDK di autenticazione Google.

Funzionalità	Scenario 1	Scenario 2	Scenario 3
Scenari di upgrade dell'autenticazione	Non a conoscenza della rimozione delle API GSI, il gioco esegue l'upgrade all'ultimo SDK di autenticazione. La funzionalità di autenticazione esistente si interrompe e SDK1 è costretto a integrare l'SDK Gestore delle credenziali. Il gioco rilascia l'ultima versione con l'ultimo SDK di autenticazione e l'SDK Gestore delle credenziali.	A conoscenza della rimozione dell'API GSI, SDK1 non esegue l'upgrade dell'SDK di autenticazione, ma alimenta la funzionalità di autenticazione Google utilizzando l'SDK Gestore delle credenziali nella sua ultima versione.	Nella sua ultima versione, SDK1 alimenta la funzionalità di autenticazione Google utilizzando l'SDK Gestore delle credenziali e rimuove completamente l'SDK di autenticazione.
SDK Play Games Services v1	Invariato	Invariato	Invariato
Cosa succede quando il gioco viene compilato	Play Games Services v1 richiede un'integrazione separata dell'SDK di autenticazione. Poiché l'SDK di autenticazione viene aggiornato senza le API GSI, Play Games Services v1 smetterà di funzionare. Il gioco riceve errori di compilazione. Il gioco tenta quindi di seguire il percorso di risoluzione.	Il gioco riceve errori di compilazione	Il gioco tenta quindi di seguire il percorso di risoluzione.
Possibile esperienza del giocatore	N/D. Poiché il gioco non può essere compilato, non è possibile pubblicarlo.	Il giocatore vede il selettore dell'account Play Games Services durante l'autenticazione utilizzando Play Games Services v1. Il giocatore vede il riquadro inferiore di Gestore delle credenziali durante l'autenticazione alla funzionalità SDK1.	Il giocatore vede il selettore dell'account Play Games Services durante l'autenticazione utilizzando Play Games Services v1. Il giocatore vede il riquadro inferiore di Gestore delle credenziali durante l'autenticazione alla funzionalità SDK1.
Percorso di risoluzione per lo sviluppatore di giochi	Scopri quale SDK sta causando l'upgrade dell'SDK di autenticazione. Ripristina la versione dell'SDK di SDK1. Ricompila il gioco con la sua funzionalità. Se la nuova funzionalità del gioco richiede un upgrade a SDK1, contatta SDK1 per adottare gli scenari 2 o 3 per la sua versione.	Nothing Tuttavia, se utilizzi anche un pulsante Accedi con Google, potresti dover utilizzare due tipi di flussi di accesso con Google per i giocatori.	Nothing Tuttavia, se utilizzi anche un pulsante Accedi con Google, potresti dover utilizzare due tipi di flussi di accesso con Google per i giocatori.
Risultato finale per Play Games Services v1	Il gioco non deve eseguire l'upgrade a Play Games Services v2, ma SDK1 rimane obsoleto.	Il gioco non deve eseguire l'upgrade da Play Games Services v1 a v2.	Il gioco non deve eseguire l'upgrade da Play Games Services v1 a v2.