弃用时间表

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

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

弃用时间表如下：

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

如果您的游戏使用的第三方 SDK 或 Google SDK（Play 游戏服务 v1 除外）需要升级身份验证，那么升级到该 SDK 的最新版本可能会导致编译错误。
  1. 遇到编译错误时，请按照此处所述的解决方法操作。
  2. 请务必在 2026 年第 2 季度末发布解决方案后，立即按照此处所述的解决方案路径迁移到 Play 游戏服务 v2。
2026 年 6 月 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 月起，Play 游戏服务 v1 SDK 将被移除。即使您使用的是旧版 SDK，对这些 API 的调用也会失败。

下表列出了 Games 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 日
：从 SDK 中移除了 Play 游戏服务 v1 API。		 迁移到 v2（Java 或 Kotlin）

GSI API 移除的影响示例

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

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

  • 修复身份验证流程中的严重 bug。
  • 实现 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 和 Credential Manager SDK。
 SDK1 知道 GSI API 已被移除，因此没有升级身份验证 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. Nothing
  2. 不过，如果您还使用了使用 Google 账号登录按钮，则可能需要为玩家使用两种类型的 Google 登录流程。
  1. Nothing
  2. 不过，如果您还使用了使用 Google 账号登录按钮，则可能需要为玩家使用两种类型的 Google 登录流程。
Play 游戏服务 v1 的最终结果 游戏无需升级到 Play 游戏服务 v2，但 SDK1 仍已过时。 游戏无需从 Play 游戏服务 v1 升级到 v2。 游戏无需从 Play 游戏服务 v1 升级到 v2。