弃用时间表

本文档列出了 Play 游戏服务 v1 SDK 的废弃时间表。

随着 Google 登录 (GSI) API 的废弃和 计划关闭，我们将废弃 Play 游戏服务 v1 SDK 和 API。 您必须将游戏迁移到 Play 游戏服务 v2 SDK，才能获得最新功能。

废弃时间表如下：

日期 废弃
里程碑		 影响 开发者
操作
2026 年 5 月 移除 GSI API 如果游戏添加了不依赖于 Google 身份验证（Play 游戏服务 v1 API 除外）的新功能（例如 LiveOps、任务或地图），这些功能将继续正常运行。

如果您的游戏使用了需要身份验证升级的第三方 SDK 或 Play 游戏服务 v1 以外的 Google SDK，则升级到该 SDK 的最新版本可能会导致编译错误。
  1. 遇到编译错误时，请按照此处提到的解决途径操作。
  2. 请务必在 2026 年第二季度末解决方案发布后，立即按照此处提到的解决方案途径迁移到 Play 游戏服务 v2。
2026 年 6 月 15 日 移除 Play 游戏服务 v1 API 我们将发布新的 Play 游戏服务 v1 SDK，其中移除了 GSI API，并且不会再针对现有 Play 游戏服务 v1 功能进行 bug 修复或更新。
如果现有 v1 游戏最终升级到最新的 Play 游戏服务 v1 版本，则此新版本上的 Play 游戏服务功能将停止运行。
  1. Play 游戏服务 v1 上的游戏不得将其 v1 SDK 升级到 com.google.android.gms:play-services-games:25.0.0，因为该版本会移除 v1 API。
  2. 任何尚未迁移到 Play 游戏服务 v2 的游戏都可能会遇到编译错误，因为自 2026 年 5 月起，play-services-auth 不再提供 GSI。
  3. 按照上一部分中提到的时间表，游戏可以密切关注其他 SDK 的升级情况，并确保在迁移到 Play 游戏服务 v2 之前，其他 SDK 不使用新的 Credential Manager SDK。
2027 年 5 月 关闭 Play 游戏服务 v1 系统会阻止来自 Play 游戏服务 v1 的所有流量，并且不会编译游戏。

现有 Play 游戏服务 v1 API 在生产环境中停止运行。 		唯一的选择是在此截止日期之前迁移到 Play 游戏服务 v2，以避免玩家入职和登录中断。

  • 2025 年 9 月之后，游戏 v1 SDK 和 API 将被废弃。集成旧版 v1 的现有游戏将继续正常运行。Google Play 会阻止发布使用 v1 SDK 和 API 的新游戏。

  • 自 2026 年 6 月 15 日起，废弃的 API 将从 SDK 中移除。

  • 自 2027 年 6 月起，游戏 v1 SDK 将被移除。即使您使用的是旧版 SDK，对这些 API 的调用也会失败。

下表列出了游戏 v1 (SDK) 版本、废弃日期和迁移指南：

SDK 版本 发布日期 迁移指南
play-services-games:v24.0.0 2025 年 9 月 12 日
已废弃		 迁移到 v2（Java 或 Kotlin）
v0.10.15 Unity 2025 年 9 月 17 日
已废弃		 迁移到 v2（Unity）
play-services-games:v25.0.0 2026 年 6 月 15 日
Play 游戏服务 v1 API 已从 SDK 中移除。		 迁移到 v2（Java 或 Kotlin）

移除 GSI API 的影响示例

假设 SDK1 从玩家的 Google 账号中检索好友列表。如需使用此功能，玩家必须使用 Google 身份验证 SDK 对其 Google 账号进行身份验证。

在以下情况下，您可能需要更新 Google 身份验证 SDK：

  • 解决身份验证流程中的严重 bug。
  • 实现 Credential Manager SDK 提供的全新通行密钥体验。

下表介绍了更新游戏身份验证集成的三种场景：

  • 场景 1： SDK1 升级到最新的 Google 身份验证 SDK。
  • 场景 2： SDK1 与 Credential Manager 集成，Google 身份验证 SDK 保持不变。
  • 场景 3： SDK1 与 Credential Manager 集成，并移除 Google 身份验证 SDK。
功能 场景 1 场景 2 场景 3
身份验证升级场景
  1. 不知道 GSI API 已被移除，游戏升级到最新的身份验证 SDK。
  2. 现有身份验证功能中断，SDK1 必须集成 Credential Manager SDK。
  3. 游戏发布了包含最新身份验证 SDK 和 Credential Manager SDK 的最新版本。
 知道 GSI API 已被移除，SDK1 不会升级身份验证 SDK，但会使用最新版本的 Credential Manager SDK 为其 Google 身份验证功能提供支持。 在最新版本中，SDK1 使用 Credential Manager SDK 为 Google 身份验证功能提供支持，并完全移除了身份验证 SDK。
Play 游戏服务 v1 SDK 未更改 未更改 未更改
编译游戏时会发生什么情况
  1. Play 游戏服务 v1 需要单独集成身份验证 SDK -> 由于身份验证 SDK 已升级且不包含 GSI API，因此 Play 游戏服务 v1 将中断。
  2. 游戏会遇到编译时错误。
  3. 然后，游戏会尝试按照解决途径操作。
 游戏会遇到编译时错误 然后，游戏会尝试按照解决途径操作。
可能的玩家体验 无。由于游戏无法编译，因此无法发布。
  1. 玩家在使用 Play 游戏服务 v1 进行身份验证时，会看到 Play 游戏服务账号选择器。
  2. 玩家在对 SDK1 功能进行身份验证时，会看到 Credential Manager 底部动作条。
  1. 玩家在使用 Play 游戏服务 v1 进行身份验证时，会看到 Play 游戏服务账号选择器。
  2. 玩家在对 SDK1 功能进行身份验证时，会看到 Credential Manager 底部动作条。
游戏开发者的解决途径
  1. 找出导致身份验证 SDK 升级的 SDK。
  2. 还原 SDK1 的 SDK 版本。
  3. 使用其功能重新编译游戏。
  4. 如果新的游戏功能需要升级到 SDK1，请与 SDK1 沟通，以便为其版本采用场景 2 或场景 3。
  1. 无
  2. 但是，如果您还使用了使用 Google 账号登录 按钮，则可能需要为玩家使用两种类型的 Google 登录 流程。
  1. 无
  2. 但是，如果您还使用了使用 Google 账号登录 按钮，则可能需要为玩家使用两种类型的 Google 登录 流程。
Play 游戏服务 v1 的最终结果 游戏不需要升级到 Play 游戏服务 v2，但 SDK1 仍然过时。 游戏不需要从 Play 游戏服务 v1 升级到 v2。 游戏不需要从 Play 游戏服务 v1 升级到 v2。