跳到主要内容
版本：v7

更新日志

7.7.0 (2026 年 06 月 10 日)​

升级请详细参考升级指南进行操作

最低版本

iOS 海外最低版本提升到 iOS 15

依赖更新
  • [Android] TapSDK 升级至 v4.10.4-beta.2
  • [Unity] TapSDK 封装包升级至 v4.10.4-xd.1
  • [iOS] AppsFlyer SDK 升级至 v6.17.9
  • [iOS] Firebase SDK 升级至 v12.2.0

Dependencies​

  • ADS 3.8.0
  • [Android] TapSDK v4.10.4-beta.2
  • [Unity] TapSDK v4.10.4-xd.1
  • [iOS] AppsFlyer SDK v6.17.9
  • [iOS] Firebase SDK v12.2.0

Features​

  • [iOS] Firebase SDK 升级至 12.2.0
  • [iOS] AppsFlyer SDK 升级至 6.17.9
  • [Android] 升级 TapSDK v4.10.4 解决 TapTap 云玩适配问题

Breaking Changes​

  • [iOS] 因 Firebase 升级，海外 iOS 最低支持版本提升到 iOS 15

Improvements​

  • [Unity][PC] SetExitHandler 支持在协议拒绝等退出场景中接管 SDK 默认退出行为
  • [Unity][PC] 优化 Toast 展示和关闭时机，避免短时间连续提示时被旧回调提前隐藏

Bugfix​

  • [iOS] 修复 Web 活动页原生分享桥接参数不一致导致无法使用检查应用是否安装接口的问题

7.6.3 (2026 年 05 月 29 日)​

升级请详细参考升级指南进行操作

依赖更新
  • ADS 3.7.1 → 3.7.2

Dependencies​

  • ADS 3.7.2
  • [Android] TapSDK v4.10.1
  • [iOS/Unity] TapSDK v4.10.2

Improvements​

  • [Android] 广告数据上报「付费」事件金额单位换算
  • [Unity][iOS] 兼容 Unity 6000 开始的 Scene 模式系统回调

Bugfix​

  • [iOS] 修复 WebView 遇到非法 URL 主动关闭时可能崩溃的问题
  • [UE][Android] 修复 XDGPush.requestPermission 非主线程调用问题

7.6.2 (2026 年 05 月 26 日)​

升级请详细参考升级指南进行操作

Dependencies​

  • ADS 3.7.1
  • [Android] TapSDK v4.10.1
  • [iOS/Unity] TapSDK v4.10.2

Bugfix​

  • [Unity][Android] 修复 Android 构建时部分模块依赖缺失的问题

7.6.1 (2026 年 05 月 13 日)​

升级请详细参考升级指南进行操作

依赖更新
  • [Android] TapSDK 升级至 v4.10.1
  • [iOS/Unity] TapSDK 升级至 v4.10.2
  • [iOS] Firebase SDK 升级至 v11.15.0
  • [Android] Google Play Billing Library 升级至 v8.3.0
  • [Android] AppsFlyer SDK 升级至 v6.15.2

Dependencies​

  • ADS 3.7.1
  • [Android] TapSDK v4.10.1
  • [iOS/Unity] TapSDK v4.10.2
  • [iOS] Firebase SDK v11.15.0
  • [Android] Google Play Billing Library v8.3.0
  • [Android] AppsFlyer SDK v6.15.2

Features​

  • 补齐 TapDB 相关接口封装
  • 新增平台沙盒能力，支持国内 Android 与 PC 包体使用
  • 初始化参数新增 gamePhase，支持游戏侧控制包体阶段参数
  • [iOS] 新增付费应用票据上传能力，用于正版验证
  • [iOS/Android] Web 框架支持原生分享
  • [Android] 适配 Android 16
  • [Unity][Android] 同步 Billing 与 Maven 相关接入能力
  • [Unity][PC] 登录支持 URL Scheme
  • [UE][PC] 登录支持 URL Scheme
  • [UE][PC] Epic 支付统一使用平台商品 ID

Improvements​

  • [Android] 用户中心绑定展示逻辑与 iOS 保持一致
  • [Android] 优化 Android ID 获取频次
  • [Unity] 支持无 Vuplex 时 iOS / Android Editor 和 Build 模式正常运行

Inner Changes​

  • [Android] Facebook 初始化相关 ContentProvider 配置放开，支持引擎层脚本写入 AndroidManifest 配置

Bugfix​

  • [Android] 修复 Unity 桥接 Android 参数 null 传递问题
  • [Android] 修复内部部分 ISC 调用不对齐的问题

7.5.0 (2026 年 04 月 02 日)​

升级请详细参考升级指南进行操作

依赖更新
  • [UE 移动端] 新增 TapSDK v4.9.0-xd 依赖基线
  • [UE PC] 新增 TapSDK v3.30.0 依赖基线

Dependencies​

  • TapSDK v4.9.0-xd (UE 移动端)
  • TapSDK v3.30.0 (UE PC 端)
  • ADS 3.7.1

Features​

  • [UE] 新增 UE 平台支持（iOS / Android / Windows）
  • [UE] 支持 UE 4.26/4.27，包含 UE5 兼容分支
  • [UE] 新增 FXDGTap 封装类，支持动态、许可证、DLC、更新、评价等能力
  • [UE] 接入方式请参考 UE 接入文档
  • [Android] XDSDK 各模块已发布到 Maven Central，支持 Maven 依赖方式集成，无需手动导入 AAR 文件（Maven GroupId: com.xd.sdk.android）
  • [Android] Chrome Custom Tabs（androidx.browser:browser）依赖已由 payment 模块自动引入，无需再手动声明
  • [Android] 详见 Android 集成文档

Breaking Changes​

7.3.4 (2026 年 04 月 22 日)​

升级请详细参考升级指南进行操作

依赖更新
  • TapSDK v4.9.0-xd.5 → v4.9.0-xd.6

Dependencies​

  • TapSDK v4.9.0-xd.6
  • ADS 3.7.1

Feature​

  • [Unity] 新增 Unity PC 读取 Tap 启动器 Channel

Bugfix​

  • [Unity] 修复 Unity PC 中 TapSDK Channel 失效的问题

7.3.3 (2026 年 02 月 12 日)​

升级请详细参考升级指南进行操作

依赖更新
  • TapSDK v4.9.0-xd.2 → v4.9.0-xd.5

Dependencies​

  • TapSDK v4.9.0-xd.5
  • ADS 3.7.1

Bugfix​

  • 修复 Android 支付接口中无法解析 extra 参数的问题

7.3.2 (2026 年 02 月 03 日)​

升级请详细参考升级指南进行操作

Dependencies​

  • TapSDK v4.9.0-xd.2
  • ADS 3.7.1

Bugfix​

  • 修复 Unity-iOS 海外收到推送时可能导致应用崩溃的问题

7.3.1 (2026 年 01 月 27 日)​

升级请详细参考升级指南进行操作

Dependencies​

  • TapSDK v4.9.0-xd.2
  • ADS 3.7.1

Bugfix​

  • 修复 Unity-Android 分享对外 API 无法正确返回三方平台是否安装的问题
  • 修复 Unity-Android 推送对外 API 无法正确返回应用前点击的通知内容
  • 修复 Unity 活动页接口回调数据解析失败的问题

7.3.0 (2026 年 01 月 12 日)​

升级请详细参考升级指南进行操作

依赖更新
  • TapSDK v4.9.0-xd.1 → v4.9.0-xd.2

Dependencies​

  • TapSDK v4.9.0-xd.2
  • ADS 3.7.1

Features​

  • [Unity] 升级 TapSDK 至 v4.9.0-xd.2
  • [Android] 支持在可用地区的 Google Play 包体中开启网页支付（默认不开启）
  • [iOS] 新增 StoreKit 2 版本的内购支持（默认不开启）
  • [PC] 内嵌 Steam SDK，支持一包多平台发布，详细参考文档

Improvements​

  • [Android] 隐私协议同意前不获取应用主体包体版本
  • 统一对外错误码规范，优化错误码含义 文档

Inner Changes​

  • [iOS] App票据上传过滤沙盒环境
  • [Unity] Android 升级阿里云一键登录 SDK（2.14.13）
  • 支付完成后提示信息文案优化

Bugfix​

  • 修复 PC 保底协议没更新导致部分情况无法同意的问题

7.2.0 (2025 年 12 月 04 日)​

升级请详细参考升级指南进行操作

Dependencies​

  • TapSDK v4.9.0-xd.1
  • ADS 3.7.1

Features​

  • SDK 支持处理国内内购前的防沉迷限额查询

Unity​

  • 优化 PC Perfab 使用自定义资源，避免无法适配游戏UI

7.1.2 (2025 年 11 月 25 日)​

升级请详细参考升级指南进行操作

依赖更新
  • TapSDK 升级至 v4.9.0-xd.1
  • ADS 兼容版本更新至 3.7.1

Dependencies​

  • TapSDK v4.9.0-xd.1
  • ADS 3.7.1

Improvements​

  • 初始化参数新增 dbProperties 参数，用于 TapDB 事件上报时可以携带自定义属性
    • 仅在 device_login 和 user_login 事件中生效

Inner Changes​

  • TapSDK 升级 v4.9.0

iOS​

  • 优化支持 app 票据上传
  • 修复查询未完成交易时的崩溃问题
  • 修复 Unity 初始化时自定义参数未成功读取的问题

Android​

  • 兼容 ADS 3.7.1
  • 修复和优化一些问题

Unity​

  • 兼容 ADS 3.7.1
  • 修复和优化一些问题

7.1.1 (2025 年 11 月 13 日)​

升级请详细参考升级指南进行操作

Dependencies​

  • TapSDK v4.8.4(Android)
  • TapSDK v4.8.1(iOS/PC)

Unity​

  • 优化新增 Tap&TapPlus Editor 程序集定义文件
  • 优化 XDGAccount.OpenUserCenter 新增支持无参调用
  • 修复登出流程与防沉迷交互导致的多次回调问题

7.1.0 (2025 年 10 月 31 日)​

升级请详细参考升级指南进行操作

Dependencies​

  • TapSDK v4.8.4(Android)
  • TapSDK v4.8.1(iOS/PC)

Features​

  • 新增公告 UI 模式接口 文档

7.0.2 (2025 年 10 月 21 日)​

升级请详细参考升级指南进行操作

依赖更新
  • [Android] TapSDK 升级至 v4.8.4

Dependencies​

  • TapSDK v4.8.4(Android)
  • TapSDK v4.8.1(iOS/PC)

Android​

  • TapSDK Android 更新 v4.8.4-beta.0
    • 修复防沉迷相关问题

iOS​

  • 修复 iOS 部分情况下关闭网页时会崩溃的问题

Unity​

  • 修复 Unity PC 部分内部逻辑问题

7.0.1 (2025 年 09 月 22 日)​

升级请详细参考升级指南进行操作

TapSDK v4.8.1

BugFix​

  • 统一用户状态回调code

7.0.0 (2025 年 09 月 18 日)​

升级请详细参考升级指南进行操作

TapSDK v4.8.1

Breaking Changes​

  • 只支持开通了 TapSDK v4 的游戏接入
  • 国内合规认证（防沉迷）相关逻辑会在 XDSDK 内部处理，游戏无需再单独处理
  • v6 升级请详细阅读 v7升级指南