跳到主要内容

6.0.1 新功能

  • 服务端归因（S2S） — SDK 现已支持服务端事件路由，适用于 Meta CAPI、Adjust S2S 和 TikTok Events API。当服务端配置开启 S2S 模式后，归因事件将通过服务端路由而非客户端发送，提升归因准确性并减少客户端广告网络调用。
  • Adjust SDK 已更新至 ~> 5.6.1。
  • 配置验证器（仅 DEBUG 模式） — SDK 现在会在启动时检查项目配置，并弹窗提示缺少的 framework、Info.plist 键或其他配置错误。此功能仅在 DEBUG 构建中运行，帮助您尽早发现集成问题。详见项目配置。

迁移指南

请根据您当前的版本选择对应的章节。

从 5.2.5 升级​

更新 Podfile​

pod 'VGPSDK', '6.0.1'

运行 pod install。

从 5.2.3 升级​

更新 Podfile​

pod 'VGPSDK', '6.0.1'

运行 pod install。

自 5.2.3 以来的更新​

  • 5.2.5：修复当推送通知 payload 包含 null 链接值时的崩溃问题。安全的 topViewController 查找，使用 Scene API。

从 5.2.2 升级​

移除 SDK 字体文件​

如果您曾手动添加 SDK 字体文件（如 .ttf 或 .otf），请将其删除，并移除 Info.plist 中对应的 UIAppFonts 条目。从 5.2.3 起，字体由 SDK 自动加载。

更新 Podfile​

pod 'VGPSDK', '6.0.1'

运行 pod install。

自 5.2.2 以来的更新​

  • 5.2.5：修复当推送通知 payload 包含 null 链接值时的崩溃问题。安全的 topViewController 查找，使用 Scene API。
  • 5.2.3：资源包已正确包含在 CocoaPods 安装中。启动时自动加载字体。

从 5.1.2 升级​

移除手动添加的文件​

  1. 移除 VGPSDK.bundle — 在 Xcode 中，于 Project Navigator 选中 VGPSDK.bundle，按 Delete → Remove Reference。同时在 Build Phases → Copy Bundle Resources 中移除相关条目（如有）。
  2. 移除 SDK 字体文件 — 如果您曾手动添加 SDK 字体文件（如 .ttf 或 .otf），请将其删除，并移除 Info.plist 中对应的 UIAppFonts 条目。

更新 Podfile​

pod 'VGPSDK', '6.0.1'

运行 pod install。

更新 Info.plist​

从 Adjust 控制台获取最新标识符，更新 SKAdNetworkItems，并确认已添加 ATT 使用说明。

请参阅项目配置中的说明。

自 5.1.2 以来的更新​

  • 5.2.5：修复当推送通知 payload 包含 null 链接值时的崩溃问题。安全的 topViewController 查找，使用 Scene API。
  • 5.2.3：资源包已正确包含在 CocoaPods 安装中。启动时自动加载字体。
  • 5.2.2：VGPSDK.bundle 现由 CocoaPods 自动分发。更新 SKAdNetworkItems 配置。

从 5.0.1 升级​

第一步：移除 VGPSDK.framework​

如果您之前在 Frameworks, Libraries, and Embedded Content 中手动添加了 VGPSDK.framework，请将其移除。

5.1.2

第二步：移除手动添加的文件​

  1. 移除 VGPSDK.bundle — 在 Xcode 中，于 Project Navigator 选中 VGPSDK.bundle，按 Delete → Remove Reference。同时在 Build Phases → Copy Bundle Resources 中移除相关条目（如有）。
  2. 移除 SDK 字体文件 — 如果您曾手动添加 SDK 字体文件（如 .ttf 或 .otf），请将其删除，并移除 Info.plist 中对应的 UIAppFonts 条目。

第三步：更新 Podfile​

编辑 Podfile 内容，仅保留 pod 'VGPSDK' 并使用新版本号：

platform :ios, '13.0'

abstract_target 'SharedPods' do
  use_frameworks!
  use_modular_headers!

  # VGP 框架
  pod 'VGPSDK', '6.0.1'

  # Unity3D 示例
  workspace 'Unity-iPhone'
  target 'Unity-iPhone' do
    project 'Unity/Unity-iPhone'
  end
  target 'UnityFramework' do
    project 'Unity/Unity-iPhone'
  end
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      cflags = config.build_settings['OTHER_CFLAGS'] || ['$(inherited)']
      cflags << '-fembed-bitcode'
      config.build_settings['OTHER_CFLAGS'] = cflags
      config.build_settings['ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES'] = 'NO'
      config.build_settings['ONLY_ACTIVE_ARCH'] = 'NO'
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
    end
  end
  # 如果你在 UnityFramework 中使用 VGPSDK，请添加以下脚本
  Dir.glob("Pods/**/Pods*iPhone*.xcconfig").each do |xcconfig_path|
    puts "Patching #{xcconfig_path}"
    text = File.read(xcconfig_path)
    text.gsub!(/^OTHER_LDFLAGS.*$/, 'OTHER_LDFLAGS = -ObjC')
    File.write(xcconfig_path, text)
  end
end

运行 pod deintegrate 然后 pod install。

第四步：更新 Info.plist​

从 Adjust 控制台获取最新标识符，更新 SKAdNetworkItems，并确认已添加 ATT 使用说明。

请参阅项目配置中的说明。

第五步：修复 UnityFramework 问题（如适用）​

请按照开发环境说明文档操作。

自 5.0.1 以来的更新​

  • 5.2.5：修复当推送通知 payload 包含 null 链接值时的崩溃问题。安全的 topViewController 查找，使用 Scene API。
  • 5.2.3：资源包已正确包含在 CocoaPods 安装中。启动时自动加载字体。
  • 5.2.2：VGPSDK.bundle 现由 CocoaPods 自动分发。更新 SKAdNetworkItems 配置。
  • 5.1.2：从手动集成 framework 迁移到 CocoaPods 分发（VGPSDK.xcframework）。所有依赖项由 CocoaPods 自动管理。