更新日志

Flutter SDK 版本历史

3.13.0 — 2026-11-18

将插件迁移到当前的 CloudX 原生 SDK 与适配器,并为插屏和激励广告新增过期广告重新加载回调。Dart 包版本跟随 iOS CloudXCore 线,因此没有 3.12.0:没有任何插件版本固定该核心版本。

原生版本固定

API

  • onExpiredAdReloaded 是 CloudXInterstitialListener 与 CloudXRewardedListener 上新增的可选回调。当已加载的全屏广告在展示前过期时,SDK 会重新加载一条替代广告,该回调会同时提供过期的广告和替代广告。现有监听器无需改动,行为也完全不变。

广告行为

  • 在展示前过期的全屏广告现在会自动重新加载(前提是 CloudX 为该广告单元启用了重新加载),并且在替代广告加载完成之前,过期的广告仍可展示。如果替代广告加载失败,将触发 onAdLoadFailed,该广告不再处于就绪状态。重新加载的重试由 CloudX 按广告单元设置且默认关闭,因此请稍后再次调用 load(),不要密集重试。若该广告单元未启用重新加载,则不会加载替代广告,出价过期后该广告即不再处于就绪状态。
  • isAdReady 从加载开始一直为 true,直到广告被展示或销毁,不再向广告网络查询。若广告网络已丢弃该广告,则在展示时通过展示失败回调返回,此时请重新加载。若该广告单元未启用过期重新加载,出价过期同样会清除就绪状态。
  • 初始化会重试临时网络故障,不再直接上报失败。初始化返回失败现在仅表示永久性错误,例如应用密钥无效。
  • Google 预估 eCPM: 通过现有的各格式设置方法(例如 CloudX.setInterstitialExtraParameter)传入 googleEstimatedEcpm 额外参数,即可告知 CloudX 一次 Google 填充的价值。无需新增 API。
  • Mediation Debugger: 在已注册的测试设备上(iOS 上在测试模式下也可以)可以只选择一个竞价方,之后新发起的 CloudX 竞价只使用该网络,直到重置或重启应用。已经加载的广告,或由其他中介平台投放的广告,仍可能来自其他网络。
  • Mediation Debugger 手势: 在已注册的测试设备上,3 秒内将手机正面朝下再翻回两次,然后长按出现的 CloudX 按钮 10 秒,即可打开 Mediation Debugger。
  • 全屏视频控件焕新(两个平台):环形倒计时、图标式跳过按钮,以及可静音和取消静音的声音按钮。
  • Android: CloudX 渲染的广告在渲染时即计入展示,不再等待可见性判定。可见性仍会被统计。

修复

  • iOS: didHideAd 现在在广告完全关闭后触发,因此可以在该回调中展示下一条广告。
  • iOS: 修复了广告网络返回异常加载错误时的崩溃、SDK 后台计时器中的崩溃,以及崩溃上报器中的崩溃,另修复了启动与退出时的看门狗终止问题。
  • Android: 跳过偏移为小数百分比(例如 12.5%)的视频广告现在会在该时间点提供跳过,而不再忽略该偏移。

许可证

Android SDK 及 CloudX Android 适配器已从 MIT 变更为 Business Source License 1.1,与 iOS SDK 此前使用的许可证一致。

宿主应用:网络适配器

本次 Android 有六个、iOS 有七个适配器升级到当前修订号;Flutter 集成指南 列出了当前版本。

CloudXMobileFuseAdapter 1.13.0.0 将部署目标提高到 iOS 15.0,因为 MobileFuse SDK 1.13.0 要求该版本。仍需支持 iOS 13 或 14 的应用请继续使用 1.12.0.0;若采用新的固定版本而未提高应用的部署目标,CocoaPods 将无法完成依赖解析。

在 Android 上,adapter-digitalturbine 升级到 8.5.0.0,adapter-inmobi 升级到 11.5.1.0,adapter-mintegral 升级到 17.1.91.0,adapter-mobilefuse 升级到 1.13.0.0,adapter-moloco 升级到 4.13.0.2,adapter-pangle 升级到 8.4.0.5.0。

在 iOS 上,CloudXMetaAdapter 升级到 6.22.1.0,CloudXVungleAdapter 升级到 7.7.8.0,CloudXMintegralAdapter 升级到 8.1.7.1,CloudXUnityAdsAdapter 升级到 4.21.0.0,CloudXMobileFuseAdapter 升级到 1.13.0.0,CloudXVerveAdapter 升级到 3.9.3.0,CloudXPangleAdapter 升级到 8.3.0.9.0。


3.11.0 — 2026-10-16

将插件迁移到当前的 CloudX 原生 SDK 与适配器,并为激励广告带来发放即奖励。Dart 包版本跟随 iOS CloudXCore 线;Android 的 io.cloudx:sdk 固定版本随每个版本一并列出。

原生版本固定

广告行为

  • 激励广告可在广告网络发放奖励时立即发放奖励,而不必等到广告关闭,因此即使用户没有关闭广告也能获得奖励。该设置由 CloudX 按账户开启,您的 onAdReceivedReward 回调无需改动。
  • iOS: 激励广告现按 CloudX 中该广告单元配置的奖励数量和货币发放,而不再采用广告网络上报的数值。
  • iOS: 未配置刷新间隔的横幅现每 30 秒刷新一次。
  • iOS: Mediation Debugger 可以分享纯文本报告,便于附在支持请求中。
  • iOS: 部分初始化工作现在在应用启动时完成,其中包含一次不携带任何标识符的 CloudX 初始化主机请求。在 Info.plist 中设置 CloudXStartupWarmDisabled 即可关闭。

修复

  • Android: 当 Android 的 WebView 渲染进程停止时,CloudX 渲染的原生广告不再导致应用崩溃。广告会隐藏主图,并保留文字、点击和展示跟踪。
  • Android: 在 Android 自身读取当前网络失败的设备上,SDK 不再崩溃。它会将其视为普通的网络错误并继续运行。
  • iOS: 全屏 HTML 广告不再以约三分之一屏幕的尺寸渲染;内置原生模板在深色模式下保持标题和正文清晰可读。

宿主应用:网络适配器

io.cloudx:adapter-magnite 升级到 1.0.2.1,随之引入 Magnite SDK 1.0.2。该 SDK 依赖 kotlin-stdlib 2.4.0,因此包含 Magnite 适配器的应用必须以 Kotlin 2.3 或更高版本编译。Kotlin 2.3 还移除了 kotlinOptions Gradle 代码块,请改用 kotlin { compilerOptions { ... } } 设置 jvmTarget。本次 Android 有十二个、iOS 有十二个适配器升级到当前修订号;Flutter 集成指南 列出了当前版本。

在 Android 上,adapter-mintegral 17.1.81.1 与 adapter-pangle 8.3.0.4.2 新增原生、原生横幅和原生 MREC 广告支持。adapter-unityads 4.21.0.2 修复了在清单中移除 Unity androidx.startup 初始化器的应用中 Unity Ads 初始化始终无法完成的问题;adapter-verve 3.9.3.0 引入 HyBid SDK 3.9.3,该版本不再声明 ACCESS_ADSERVICES_TOPICS 权限。

在 iOS 上,CloudXMagniteAdapterV2 1.0.4.2 修复了在 CloudX 初始化完成前设置用户同意或拒绝出售(do-not-sell)的应用中的启动崩溃,并撤回 1.0.4.0 与 1.0.4.1。CloudXMobileFuseAdapter 1.12.0.0 引入 MobileFuse SDK 1.12.0,修复了生成竞价令牌时的崩溃风险;CloudXInMobiAdapter 11.5.0.0 与 CloudXMintegralAdapter 8.1.7.0 分别升级到 InMobi SDK 11.5.0 和 Mintegral SDK 8.1.7。


3.10.0 — 2026-10-08

新增聚合调试器,并将插件迁移到当前的 CloudX 原生 SDK 与适配器。Dart 包版本跟随 iOS CloudXCore 线;Android 的 io.cloudx:sdk 固定版本随每个版本一并列出。

原生版本固定

  • iOS: CloudXCore 3.10.0
  • Android: io.cloudx:sdk 4.9.0

API

  • 初始化完成后调用 CloudX.showMediationDebugger(),即可查看每个适配器的状态、隐私信号和广告单元,为任意广告单元加载测试广告,并为下次启动申请测试模式。初始化完成前调用会返回 false。
  • CloudXAd.creativeId 提供需求来源上报的素材标识(该来源上报时)。

广告行为

  • 广告遵循广告主设定的过期时间。 在两个平台上,全屏广告现会在其出价过期时过期;展示已过期的全屏广告会以错误码 616 失败。请在展示前检查广告是否就绪;请加载新的广告。
  • Android: 已加载的横幅或 MREC 之后失败时,现会报告 onAdLoadFailed。自动刷新停止期间,SDK 不再自行重新加载;请调用 load() 请求新广告。
  • Android: CloudX 渲染的插屏和激励广告现在在应用自身的任务栈中打开,因此启动 Activity 设置了 android:taskAffinity=""(Flutter 模板的默认值)的应用,从主屏返回后不再出现广告卡死和后续加载被阻塞的问题。
  • Android: 在进程启动时,SDK 现仅安排预热工作,并在应用首次进入前台后再进行 WebView 和网络预热。FCM 和 WorkManager 等后台进程会跳过预热,从而降低 ANR 风险。
  • 当广告来源上报展示级收入时,收入回调报告实际金额;对于已自行向您的 MMP 上报收入的出价方,MMP 连接器不再接收其 CloudX 竞得展示。
  • iOS: 重复调用 CloudX.initialize 不再启动两次初始化,第二次调用会等待第一次尝试完成;收入回调现在会在测试模式下触发,回调中 revenue 为 0;CloudX 渲染的全屏视频广告的点击现在在您的应用内打开 App Store,不再跳出应用,且点击回调仅在用户真实点击时触发。

修复

  • Android: 横幅和 MREC 广告位中的 CloudX 原生广告现从您的 Activity 主题获取文字颜色,标题和正文在深色主题下保持清晰可读。
  • Android: 含绝对定位内容的 CloudX 渲染 HTML 广告不再出现偏移或裁切。小于广告位的素材现对齐到左上角,而不再居中。

宿主应用:网络适配器

BIGO Ads 现已在两个平台提供(io.cloudx:adapter-bigo 与 CloudXBigoAdapter 6.1.0.0)。在 iOS 上,引入该 pod 会让 Flutter 工具链从模拟器构建中去掉 arm64,因此请在真机上测试 BIGO。Flutter 集成指南 链接了列出当前适配器版本的 Android 与 iOS 指南。


3.9.0 — 2026-09-11

将插件迁移到当前的 CloudX 原生 SDK,并新增 Trusted Arbiter。Dart 包版本跟随 iOS CloudXCore 线;Android 的 io.cloudx:sdk 固定版本随每个版本一并列出。

原生版本固定

  • iOS: CloudXCore 3.9.0
  • Android: io.cloudx:sdk 4.7.0

API

  • CloudX.initialize 返回 CloudXInitializationResult。请检查 result.success;失败时会带上原生 SDK 的错误码、错误码名称和错误信息,因此可以区分应用密钥错误与网络失败。
  • 单次加载的额外参数:setBannerExtraParameter、setMrecExtraParameter、setInterstitialExtraParameter 和 setRewardedExtraParameter 可为该广告单元的下一次加载附加一组键值。参见单次加载的额外参数。
  • CloudXError.codeName 会带上 SDK 为该错误码定义的名称,因此日志会显示为 NO_FILL[302] 而不是 302。初始化失败则由 CloudXInitializationResult.errorCodeName 提供同样的信息。
  • 新增错误码:CloudXErrorCode.adNotFound(403)表示展示时找不到该广告单元的广告,displayHostUnavailable(404)表示没有可用于展示的宿主。
  • 新增加载错误码:loadNotAllowedWhileShowing(303)和 loadFailed(304),以及广告单元在已有加载进行中时可能返回的拒绝,Android 编号为 305,iOS 为 306。这两个都要处理,因为两个平台互不上报对方的值。

Trusted Arbiter

  • CloudX.arbiter 会把已加载的 CloudX 广告与您自行接入平台的出价进行比较,并返回应当展示的平台。出价工厂覆盖 CloudX、AdMob、Google Ad Manager、Unity LevelPlay、PubMatic 和自定义来源。参见 Trusted Arbiter。
  • CloudX.reportRevenueData 把其他中介平台的展示收入转发给 CloudX。AdMob 和 Ad Manager 的出价依赖这些历史数据定价,因此该接口是必需的。
  • CloudXAd.adValues 暴露 SDK 附加在已加载广告上的元数据。请把 onAdLoaded 中的 CloudXAd 原样传给 CloudXArbiterBid.cloudX。

广告行为

  • iOS: 全屏广告从最顶层的视图控制器展示;在系统 UI(如弹窗或分享面板)之上的展示会被拒绝,并在失败信息中给出原因。
  • 测试模式下不回调收入,测试用的哨兵价格不会进入您的收入监听器。
  • 此前广告事件若缺少字段或字段类型异常,会在到达监听器之前被丢弃。现在该回调会正常送达,并把缺失字段标记为不存在。

宿主应用:网络适配器

发布的插件仅包含核心。适配器按 <网络 SDK 版本>.<适配器修订号> 独立编号,与核心 SDK 各自演进,因此适配器版本无需与插件版本一致。Flutter 集成指南 说明在何处声明适配器,并链接到列有当前版本和各网络要求的 Android 与 iOS 指南。

广告格式

本次发布支持横幅广告、MREC、插屏广告和激励视频广告。横幅广告和 MREC 以程序化浮层展示;插屏广告和激励视频广告则通过程序化 API 加载和展示。参见横幅广告和 MREC、插屏广告和激励视频广告。


2.2.3 — 2026-03-19

pub.dev 上的首个公开发布。Dart 软件包的 major.minor.patch 与其绑定的 CloudX 原生 SDK 一致(iOS CloudXCore、Android io.cloudx:sdk)。

要求

  • Dart SDK: >=2.17.1 <4.0.0(见 pub.dev 上的软件包 pubspec)
  • Flutter: >=3.0.0
  • iOS: 13.0+
  • Android: minSdk 23 (API 23)

Dart 下限刻意设低,以便仍在较旧稳定 Flutter 线上的应用可以采用 cloudx_flutter,而不必整套工具链升级。

本版本包含

  • 横幅、MREC、插屏和激励视频广告;程序化浮层 API 以及内嵌 CloudXAdView
  • 监听器回调、定向键值、展示级收入(onAdRevenuePaid)及相关生命周期事件
  • 隐私辅助方法 CloudX.setHasUserConsent 和 CloudX.setDoNotSell(可空的 bool? 会清除覆盖,并在适用时回退到 CMP)
  • 原生版本锁定:CloudXCore 2.2.3(iOS)、io.cloudx:sdk 2.2.3(Android)

宿主应用:广告网络适配器

已发布的插件仅包含核心。请只在 CocoaPods 和 Gradle 中声明您需要的广告网络适配器,版本均为 2.2.3(Meta、Vungle、InMobi、Mintegral、Unity Ads、renderer 等)。对于 Unity Ads,请添加 CloudXUnityAdsAdapter 和 io.cloudx:adapter-unityads。

Android:Mintegral

如果您依赖 io.cloudx:adapter-mintegral,必须在 Gradle 中添加 Mintegral 的 Maven 仓库 —— 制品不在 Maven Central。见 Android Mintegral 适配器 — Maven 仓库。