Harmonogram wycofywania

W tym dokumencie znajdziesz harmonogram wycofywania pakietu SDK usług gier Play w wersji 1.

Po wycofaniu interfejsu Logowanie przez Googleplanowanym wyłączeniu wycofujemy pakiet SDK i interfejsy API usług gier Play w wersji 1. Aby uzyskać dostęp do najnowszych funkcji, musisz przenieść grę na pakiet SDK usług gier Play w wersji 2.

Harmonogram wycofywania:

Data Kamień milowy wycofania
Wpływ Działanie dewelopera
Maj 2026 r. Usunięcie interfejsu GSI API Jeśli gra doda nowe funkcje, takie jak operacje na żywo, misje lub mapy, które nie korzystają z uwierzytelniania Google z wyjątkiem interfejsu API Usług gier Play w wersji 1, te funkcje będą nadal działać.

Jeśli Twoja gra korzysta z pakietu SDK innej firmy lub pakietu SDK Google innego niż usługi gier Play w wersji 1, który wymaga uaktualnienia uwierzytelniania, uaktualnienie do najnowszej wersji tego pakietu SDK może spowodować błędy kompilacji.
  1. Jeśli wystąpi błąd kompilacji, postępuj zgodnie z podanymi tu instrukcjami.
  2. Po udostępnieniu rozwiązania pod koniec drugiego kwartału 2026 r. przeprowadź migrację do usług gier Play w wersji 2 zgodnie z opisaną tutaj ścieżką rozwiązania.
15 czerwca 2026 r. Usunięcie interfejsu API Usług gier Play w wersji 1 Opublikujemy nowy pakiet SDK usług gier Play w wersji 1 z usuniętymi interfejsami API GSI. Nie będzie on już zawierać poprawek ani aktualizacji dotychczasowych funkcji usług gier Play w wersji 1.
Jeśli dotychczasowy 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 korzystające z usług gier Play w wersji 1 nie mogą uaktualniać 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 gier, które nie zostały przeniesione do usług gier Play w wersji 2, mogą wystąpić błędy kompilacji, ponieważ od maja 2026 r. play-services-auth nie będzie już udostępniać GSI.
  3. Zgodnie z harmonogramem podanym w poprzedniej sekcji gry mogą zachować czujność w zakresie uaktualniania innych pakietów SDK i upewnić się, że nie używają one nowego pakietu SDK Menedżera danych logowania, 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 przestaną działać w środowisku produkcyjnym.
Jedyną opcją jest przejście na usługi gier Play w wersji 2 przed tym terminem, aby uniknąć problemów z wprowadzaniem graczy i logowaniem.
  • Po wrześniu 2025 r. wycofamy pakiet SDK i interfejsy API do gier w wersji 1. Dotychczasowe tytuły z integracjami w wersji 1 będą nadal działać. Google Play uniemożliwi 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 będą usuwane z pakietu SDK.

  • W czerwcu 2027 r. usuniemy pakiet SDK do gier w wersji 1. Wywołania tych interfejsów API zakończą się niepowodzeniem, nawet jeśli używasz poprzednich 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.
Wycofane
Migracja do wersji 2(Java lub Kotlin)
v0.10.15 Unity 17 września 2025 r.
Wycofane
Migracja do wersji 2(Unity)
play-services-games:v25.0.0 15 czerwca 2026 r.
Usunięcie z pakietu SDK interfejsu API usług gier Play w wersji 1.
Migracja do wersji 2(Java lub Kotlin)

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

Rozważmy sytuację, w której pakiet 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ąż krytyczny błąd w procesie uwierzytelniania.
  • Wdrażaj nowe funkcje kluczy dostępu oferowane przez pakiet SDK Menedżera danych logowania.

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

  • Scenariusz 1: pakiet SDK1 przechodzi na najnowszą wersję pakietu SDK do uwierzytelniania Google.
  • Scenariusz 2: pakiet SDK1 integruje się z Menedżerem danych logowania, a pakiet SDK do uwierzytelniania Google pozostaje bez zmian.
  • Scenariusz 3: pakiet SDK1 integruje się z Menedżerem danych logowania i usuwa pakiet Google Authentication SDK.
Funkcja Scenariusz 1 Scenariusz 2 Scenariusz 3
Scenariusze uaktualniania uwierzytelniania
  1. Nie wie o usunięciu interfejsów GSI API, gra jest aktualizowana do najnowszego pakietu SDK do uwierzytelniania.
  2. Dotychczasowa funkcja uwierzytelniania przestaje działać, a pakiet SDK1 musi zintegrować pakiet SDK Menedżera danych logowania.
  3. Gra publikuje najnowszą wersję z najnowszym pakietem SDK do uwierzytelniania i pakietem SDK Credential Manager.
Wiedząc o usunięciu interfejsu GSI API, firma SDK1 nie uaktualnia pakietu SDK do uwierzytelniania, ale obsługuje funkcję uwierzytelniania Google za pomocą pakietu Credential Manager SDK w najnowszej wersji. W najnowszej wersji pakiet SDK1 obsługuje funkcję uwierzytelniania Google za pomocą pakietu SDK Menedżera danych logowania 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ą osobnej integracji pakietu SDK do autoryzacji –> ponieważ pakiet SDK do autoryzacji jest uaktualniany bez interfejsów GSI API, usługi gier Play w wersji 1 przestaną działać.
  2. W grze występują błędy czasu kompilacji.
  3. Gra próbuje wtedy podążać ścieżką rozwiązania.
W grze występują błędy kompilacji Gra próbuje wtedy podążać ścieżką rozwiązania.
Możliwe wrażenia gracza Nie dotyczy. Nie można skompilować gry, więc 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. Gdy gracz uwierzytelnia się w funkcji pakietu SDK1, widzi u dołu ekranu 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. Gdy gracz uwierzytelnia się w funkcji pakietu SDK1, widzi u dołu ekranu planszę dolną Menedżera danych logowania.
Ścieżka rozwiązania dla dewelopera gier
  1. Sprawdź, który pakiet SDK powoduje aktualizację pakietu SDK do uwierzytelniania.
  2. Przywróć wersję pakietu SDK1.
  3. Ponownie skompiluj grę z tą funkcją.
  4. Jeśli nowa funkcja gry wymaga uaktualnienia do pakietu SDK1, skontaktuj się z dostawcą pakietu SDK1, aby wdrożyć scenariusz 2 lub 3 w jego wersji.
  1. Nothing
  2. Jeśli jednak używasz też przycisku Zaloguj się przez Google, możesz musieć używać 2 rodzajów procesów logowania przez Google dla graczy.
  1. Nothing
  2. Jeśli jednak używasz też przycisku Zaloguj się przez Google, możesz musieć używać 2 rodzajów procesów logowania przez Google dla graczy.
Ostateczny wynik dla usług gier Play w wersji 1 Gra nie musi być uaktualniana do usług gier Play w wersji 2, ale pakiet SDK1 pozostaje nieaktualny. Gra nie musi przechodzić z usług gier Play w wersji 1 na wersję 2. Gra nie musi przechodzić z usług gier Play w wersji 1 na wersję 2.