Harmonogram wycofywania

Ten dokument zawiera harmonogram wycofania pakietu SDK usług gier Play w wersji 1.

Po wycofaniu interfejsu Google Sign-in (GSI) API i planowanym wyłączeniu wycofujemy pakiet SDK i interfejsy API usług gier Play w wersji 1. Aby korzystać z najnowszych funkcji, musisz przeprowadzić migrację gry do pakietu SDK usług gier Play w wersji 2.

Harmonogram wycofania:

Data Etap wycofania
 Wpływ Działania dewelopera
Wrzesień 2026 r. Usunięcie interfejsu GSI API Jeśli gra dodaje nowe funkcje, takie jak LiveOps, misje lub mapy, które nie korzystają z uwierzytelniania Google (z wyjątkiem interfejsu usług Gier Play w wersji 1 API), te funkcje będą nadal działać.

Jeśli gra korzysta z pakietu SDK innej firmy lub pakietu SDK Google innego niż usługi Gier Play w wersji 1, który wymaga aktualizacji uwierzytelniania, aktualizacja do najnowszej wersji tego pakietu SDK może spowodować błędy kompilacji.
  1. W przypadku błędu kompilacji postępuj zgodnie ze ścieżką rozwiązania opisaną tutaj.
  2. Po opublikowaniu rozwiązania pod koniec II kwartału 2026 r. przeprowadź migrację do usług gier Play w wersji 2 zgodnie ze ścieżką rozwiązania opisaną tutaj.
Czerwiec 2026 r. Usunięcie interfejsu API usług Gier Play w wersji 1 Opublikowaliśmy nowy pakiet SDK usług gier Play w wersji 1, z którego usunięto interfejsy GSI API. Nie będzie on już otrzymywać poprawek ani aktualizacji istniejących funkcji usług gier Play w wersji 1.
Jeśli istniejący tytuł w wersji 1 zostanie zaktualizowany do najnowszej wersji usług gier Play w wersji 1, funkcje usług gier Play w tej nowej wersji przestaną działać.
  1. Gry w usługach gier Play w wersji 1 nie mogą aktualizować pakietu SDK w wersji 1 do wersji com.google.android.gms:play-services-games:25.0.0, która usuwa interfejsy API w wersji 1.
  2. W przypadku każdej gry, która nie została przeniesiona do usług gier Play w wersji 2, mogą wystąpić błędy kompilacji, ponieważ od maja 2026 r. pakiet play-services-auth nie będzie już obsługiwać GSI.
  3. Zgodnie z harmonogramem podanym w poprzedniej sekcji gry mogą zachować czujność w kwestii aktualizowania innych pakietów SDK i upewnić się, że inne pakiety SDK nie używają nowego pakietu Credential Manager SDK, dopóki nie zostaną przeniesione do usług gier Play w wersji 2.
Maj 2027 r. Wyłączenie usług gier Play w wersji 1 Cały ruch z usług gier Play w wersji 1 jest blokowany bez kompilacji gry.

Istniejące interfejsy API usług Gier Play w wersji 1 przestają działać w środowisku produkcyjnym. 		Jedyną opcją jest migracja do usług gier Play w wersji 2 przed tą datą, aby uniknąć przerw w procesie wdrażania i logowania graczy.

  • Po wrześniu 2025 r. pakiet SDK i interfejsy API do gier w wersji 1 zostaną wycofane. Dotychczasowe tytuły z integracjami w wersji 1 będą nadal działać. Google Play uniemożliwia publikowanie nowych tytułów, które korzystają z pakietu SDK i interfejsów API w wersji 1.

  • Od 15 czerwca 2026 r. wycofane interfejsy API zostały usunięte z pakietu SDK.

  • Od września 2026 r. interfejs Logowanie przez Google dla Androida API nie jest już obsługiwany.

  • Od czerwca 2027 r. pakiet SDK do gier w wersji 1 zostanie usunięty. Wywołania tych interfejsów API będą kończyć się niepowodzeniem, nawet jeśli używasz starszych wersji pakietu SDK.

W tabeli poniżej znajdziesz wersje pakietu SDK do gier w wersji 1, daty ich wycofania i przewodniki po migracji:

Wersja SDK Data premiery Przewodnik po migracji
play-services-games:v24.0.0 12 września 2025 r.
Wycofany		 Migracja do wersji 2(Java lub Kotlin)
v0.10.15 Unity 17 września 2025 r.
Wycofany		 Migracja do wersji 2(Unity)
play-services-games:v25.0.0 15 czerwca 2026 r.
Interfejs API usług Gier Play w wersji 1 został usunięty z pakietu SDK.		 Migracja do wersji 2(Java lub Kotlin)

Przykładowy wpływ usunięcia interfejsu GSI API

Rozważmy scenariusz, w którym pakiet SDK, SDK1, pobiera listę znajomych z konta Google gracza. Aby korzystać z tej funkcji, gracze muszą uwierzytelnić swoje konto Google za pomocą pakietu SDK uwierzytelniania Google.

W tych sytuacjach może być konieczne zaktualizowanie pakietu SDK uwierzytelniania Google:

  • Rozwiązanie krytycznego błędu w procesie uwierzytelniania.
  • Wdrożenie nowych funkcji kluczy dostępu oferowanych przez pakiet Credential Manager SDK.

W tabeli poniżej opisujemy 3 scenariusze aktualizacji integracji uwierzytelniania w grze:

  • Scenariusz 1: SDK1 aktualizuje się do najnowszego pakietu SDK uwierzytelniania Google.
  • Scenariusz 2: SDK1 integruje się z Menedżerem danych logowania, pozostawiając pakiet SDK uwierzytelniania Google bez zmian.
  • Scenariusz 3: SDK1 integruje się z Menedżerem danych logowania i usuwa pakiet SDK uwierzytelniania Google.
Funkcja Scenariusz 1 Scenariusz 2 Scenariusz 3
Scenariusze aktualizacji uwierzytelniania
  1. Gra nie wie o usunięciu interfejsów GSI API i aktualizuje się do najnowszego pakietu SDK uwierzytelniania.
  2. Dotychczasowa funkcja uwierzytelniania przestaje działać, a SDK1 musi zintegrować pakiet Credential Manager SDK.
  3. Gra publikuje najnowszą wersję z najnowszym pakietem SDK uwierzytelniania i pakietem Credential Manager SDK.
 SDK1 wie o usunięciu interfejsu GSI API, nie aktualizuje pakietu SDK uwierzytelniania, ale obsługuje funkcję uwierzytelniania Google za pomocą pakietu Credential Manager SDK w najnowszej wersji. W najnowszej wersji SDK1 obsługuje funkcję uwierzytelniania Google za pomocą pakietu Credential Manager SDK i całkowicie usuwa pakiet SDK uwierzytelniania.
Pakiet SDK usług gier Play w wersji 1 Bez zmian Bez zmian Bez zmian
Co się dzieje podczas kompilacji gry
  1. Usługi gier Play w wersji 1 wymagają oddzielnej integracji pakietu SDK uwierzytelniania. Ponieważ pakiet SDK uwierzytelniania został zaktualizowany bez interfejsów GSI API, usługi gier Play w wersji 1 przestaną działać.
  2. W grze występują błędy czasu kompilowania.
  3. Gra próbuje wtedy postępować zgodnie ze ścieżką rozwiązania.
 W grze występują błędy czasu kompilowania. Gra próbuje wtedy postępować zgodnie ze ścieżką rozwiązania.
Możliwe wrażenia gracza Nie dotyczy. Ponieważ nie można skompilować gry, nie można jej opublikować.
  1. Podczas uwierzytelniania za pomocą usług gier Play w wersji 1 gracz widzi selektor konta usług gier Play.
  2. Podczas uwierzytelniania w funkcji SDK1 gracz widzi planszę dolną Menedżera danych logowania.
  1. Podczas uwierzytelniania za pomocą usług gier Play w wersji 1 gracz widzi selektor konta usług gier Play.
  2. Podczas uwierzytelniania w funkcji SDK1 gracz widzi planszę dolną Menedżera danych logowania.
Ścieżka rozwiązania dla dewelopera gry
  1. Sprawdź, który pakiet SDK powoduje aktualizację pakietu SDK uwierzytelniania.
  2. Przywróć wersję pakietu SDK1.
  3. Ponownie skompiluj grę z jej funkcją.
  4. Jeśli nowa funkcja gry wymaga aktualizacji do SDK1, skontaktuj się z SDK1, aby wdrożyć scenariusze 2 lub 3 w swojej wersji.
  1. Nothing
  2. Jeśli jednak używasz też przycisku Zaloguj się przez Google, być może będziesz musiał/a użyć 2 typów procesów logowania przez Google dla graczy.
  1. Nothing
  2. Jeśli jednak używasz też przycisku Zaloguj się przez Google, być może będziesz musiał/a użyć 2 typów procesów logowania przez Google dla graczy.
Ostateczny wynik dla usług gier Play w wersji 1 Gra nie musi być aktualizowana do usług gier Play w wersji 2, ale SDK1 pozostaje nieaktualny. Gra nie musi być aktualizowana z usług gier Play w wersji 1 do wersji 2. Gra nie musi być aktualizowana z usług gier Play w wersji 1 do wersji 2.