跳到主要内容

升级指南

从 3.5.0 升级到 3.5.1​

在这个版本中支持了 iOS 的巨量 SDK 的接入，请参考 iOS 集成说明。另外 Android 端广点通 SDK 升级到了 1.9.0，修复了广点通渠道激活事件未正常上报的问题，无需其他额外操作。

从 3.4.0 升级到 3.5.0​

在 v3.5.0 版本中，升级了今日头条商业化组件 SDK 版本至 1.3.0.4 并移除了本地头条分包 SDK aar 库的依赖（humesdk-1.0.0.aar），游戏如采用原生集成方式，请移除该 aar 库的依赖。当前主要是头条 SDK 解决了应用包体大于 2GB 时无法正确获取渠道信息造成归因数据异常。

从 3.3.0 升级到 3.4.0​

在 v3.4.0 版本中，升级了今日头条埋点 SDK 版本至 6.16.3，主要是适配最新的广告渠道 SDK，内部优化了付费事件上报时金额的取舍。如果是 Unity/UE 集成，升级无其他注意事项；如果是 Android 原生集成，请注意头条商业化转化组件的依赖形式以变更，参考如下：

// Applog 上报组件（必须）
implementation 'com.bytedance.applog:RangersAppLog-Lite-cn:6.16.3'
// 商业化组件（必须） 6.14.2 以上版本商业化组件独立，注：必须接入以免平台限制应用上传
// 老版本组件名称为：implementation 'com.bytedance.applog:RangersAppLog-All-convert:6.14.3'
// 头条广告埋点 SDK 从 6.15.4 版本开始已更改组件名称，如有旧版 SDK 依赖，可以删除依赖，并添加以下依赖
implementation 'com.bytedance.ads:AppConvert:1.2.3'

从 v3.2.x 升级到 3.3.0​

在 v3.3.0 版本中，升级了广点通埋点 SDK 版本至 1.8.9，主要是因为隐私合规问题的修复；在 Unity & UE 环境下，我们通过脚本对广告包分包配置上进行了判断，动态区别是否需要对应的第三方平台 SDK 的依赖，包含了今日头条广告 SDK 、今日头条分包 SDK 、广点通广告 SDK 、广点通分包 SDK 。 另外在这个版本中我们对全平台生命周期函数方法进行了删除（参见下文 v3.1.0 升级到 v3.2.0 的注意事项），如游戏有调用，请将该方法调用删除，内部不影响生命周期统计。

Unity 下从 v3.2.0 升级到 v3.2.2​

由于 v3.2.0 模块中的 asmdef 文件配置不正确，可能导致打包失败。此外，如果在打包过程中启用了 Strip Engine Code 功能，可能会导致 xdsdk_ads_subpkg 中的代码被剥离。在 v3.2.2 版本中，我们已经解决了这些问题。只需将版本号从 v3.2.0 升级到 v3.2.2，无需额外的操作即可解决这些问题。（不建议使用 v3.2.1 版本，因为 v3.2.1 版本只修复了 asmdef 配置的问题。）

从 v3.1.0 升级到 v3.2.0​

在 v3.2.0 版本中，升级了对头条广告埋点 SDK 版本的升级（v6.14.3)，请注意，在这个版本中需要额外添加头条广告埋点的仓库地址才能拉下来广告埋点 SDK 的代码，请参照接入指南中的 TT SDK 集成文档进行升级；Unity 集成方式不变，升级 xdsdk_ads_subpkg 模块的版本即可。 另外，对于生命周期函数的方法目前在头条广告埋点 SDK 中已经自动计入，无需主动调用，目前已将 Android 和 Unity 的方法进行了 Deprecated/Obsolete 的标记，未来会将此方法进行删除，游戏可自行删除，也可不用变更，分包/广告包 SDK 内部已经做好处理。

从 v3.0.0 升级到 v3.1.0​

在 v3.1.0 版本中，对快手分包 SDK 进行了支持，游戏可按照接入指南中的 KS SDK 集成进行集成； Unity 直接使用 upm 或 npm 的方式集成 XDSDK 的 xdsdk_ads_subpkg 模块即可。