Skip to main content
Version: v4

SDK v3 升级 v4 的说明

本文介绍 v3(3.X) 版本 SDK 如何升级到 v4(4.X) 版本。

说明​

2024 年 8 月 30 日，我们上线了 v4 版本 SDK，同时更新了开发者中心控制台，新创建的游戏应用默认是 v4 版本应用。新应用请配套使用 v4.3.10 及以上版本 TapSDK，文档请参考 v4 版本 TapSDK 文档。

此前创建的应用为 v3 版本，可以继续使用 v3 版本 TapSDK，参考 v3 版本 TapSDK 文档进行集成。相关服务仍将可用。对于符合条件的 v3 应用想要升级使用 v4 版本 SDK，也可通过工单申请，申请通过并升级完成后可以参考 v4 版本 TapSDK 文档进行集成。

tip
  • 新版 v4 服务不再包含内建账户（同时取消了域名绑定功能）、云引擎、数据存储、多人在线对战、悬浮窗相关功能。

如何判断开发者后台应用是 v3 还是 v4 版本​

可以通过开发者后台游戏服务页面的样式布局进行判断，两个版本后台的样式分别如下图：

  • v4 应用游戏服务页面样式：

v4-后台样式

  • v3 应用游戏服务页面样式：

v3-�后台样式

v3 应用升级使用 v4 版本 SDK 的条件​

  1. 之前未使用内建账户、云存档、成就、排行榜、数据存储、悬浮窗、游戏好友、云引擎、多人在线对战、TapTap 好友、自定义域名、客服系统的情况下可以申请升级。
  2. 如果之前使用了内建账户等云服务并产生了数据，但是以后不需要这些数据和服务的情况下，可以自行清空后台这些数据并解绑自定义域名，然后可以申请升级。

当 v3 版本应用集成 v4 版本 SDK 的异常现象​

  1. 执行初始化代码后，控制台会打印如下图中日志：

  1. 执行初始化代码后，应用会弹出如下图中的提示：

当出现以上情况表示你的应用版本和集成的 SDK 版本不匹配，有以下两种方案：

  1. 继续使用 v3 版本 SDK;

  2. 参考v3 应用升级使用 v4 版本 SDK 的条件说明，自行评估是否需要升级到 v4 版本，当确认升级时，请通过工单进行申请（工单中请告知应用 Client id）。