cloudx_flutter 3.13.0
cloudx_flutter: ^3.13.0 copied to clipboard
Complete Flutter SDK wrapper for CloudX Core with targeting APIs and full ad lifecycle callbacks
Changelog #
All notable changes to the CloudX Flutter SDK will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Versioning #
cloudx_flutter on pub follows the major.minor.patch of the iOS CloudXCore it pins, the same convention as cloudx-react-native. The Android io.cloudx:sdk line has diverged from iOS and is listed per release:
cloudx_flutter |
iOS (CloudXCore) |
Android (io.cloudx:sdk) |
|---|---|---|
| 3.13.0 | 3.13.0 | 4.13.0 |
| 3.11.0 | 3.11.0 | 4.10.0 |
| 3.10.0 | 3.10.0 | 4.9.0 |
| 3.9.0 | 3.9.0 | 4.7.0 |
| 3.8.0 | 3.8.0 | 4.7.0 |
| 2.2.3 | 2.2.3 | 2.2.3 |
Releases before 2.2.3 used 0.16.x–0.18.x for the Dart package only; those numbers were not the native SDK version. 2.2.3 matched both natives while they still shared one number.
Native pins come from the public docs repo (en/ios/integration.mdx, en/android/integration.mdx, and the per-adapter overview.mdx pages), applied by scripts/sync-native-pins.sh. Ad-network adapters are versioned <network-sdk-version>.<adapter-revision> and move independently of the core SDKs.
[Unreleased] #
Added #
CloudXErrorCode.unsupportedRenderer(623): a creative type the CloudX renderer cannot show for the format. Android sends it once the plugin pins an Android SDK later than 4.13.0; earlier Android SDKs sendadapterInitializationError(607).
Changed #
- iOS: the concurrency rejection is
305, as on Android, once the plugin pins an iOSCloudXCorelater than 3.13.0. iOS 3.13.0 and earlier send306. Keep checking bothloadRejectedConcurrency(305) andloadRejectedTooManyConcurrentLoads(306).
3.13.0 - 2026-11-18 #
Version 3.12.0 was skipped: the plugin follows the iOS CloudXCore line, and no plugin release pinned CloudXCore 3.12.0.
Added #
onExpiredAdReloadedon the interstitial and rewarded listeners. The SDK reloads a fullscreen ad that expired before it was shown, and this callback hands you the expired ad and its replacement. It is optional, so existing listeners keep working untouched.- Mediation Debugger bidder picker. On a registered test device, pick one bidder and new CloudX auctions use only that network until you reset it or restart the app. Ads already loaded, or served by another mediator, can still come from other networks.
- Android: a gesture opens the Mediation Debugger on a registered test device. Turn the phone face down and back up twice within 3 seconds, then hold the CloudX button for 10 seconds.
- Google Estimated eCPM. Pass what a Google fill is worth as the
googleEstimatedEcpmextra parameter through the existing per-format setters, such assetInterstitialExtraParameter. No new API.
Changed #
- Native SDKs: pins Android
io.cloudx:sdk4.13.0 (from 4.10.0) and iOSCloudXCore3.13.0 (from 3.11.0). Apps inherit every native change in between: Android changelog, iOS changelog. - A fullscreen ad that expires before it is shown reloads itself when CloudX enables reload for the ad unit; the expired ad stays showable meanwhile. If the replacement fails to load,
onAdLoadFailedfires and the ad stops being ready: retries are off by default, so callload()again. isAdReadystays true from load until the ad is shown or destroyed and no longer checks with the ad network. With reload off for the ad unit, an expired bid clears it. An ad the network dropped fails at show with a display-failed callback; load a new one.- Initialization retries temporary network failures rather than reporting them. A failed result now means a permanent error such as an invalid app key.
- Refreshed full-screen video controls on both platforms: a circular countdown, an icon Skip button, and a sound button so users can mute and unmute.
- Android: CloudX-rendered ads count the impression when they render instead of waiting on viewability. Viewability is still measured.
- Android licence: the Android SDK and the CloudX adapters moved from MIT to the Business Source License 1.1, which is the licence the iOS SDK already used.
- Adapters: six Android and seven iOS adapters move to their current revisions. The Flutter integration guide carries the versions.
- iOS, if you enable MobileFuse:
CloudXMobileFuseAdapter1.13.0.0 requires iOS 15.0, because MobileFuse SDK 1.13.0 declares it. Apps still supporting iOS 13 or 14 stay on 1.12.0.0.
Fixed #
- iOS:
didHideAdnow fires after the ad has fully closed, so showing the next ad from that callback works. - iOS: fixed a crash on an unusual network load error, one in the SDK's background timer, and one in its crash reporter, plus launch and exit watchdog terminations.
- Android: a video ad with a decimal percentage skip offset, such as 12.5%, now offers Skip at that point instead of ignoring the offset.
3.11.0 - 2026-10-16 #
Added #
- iOS: the Mediation Debugger can share a plain-text report, for attaching to a support request.
- iOS: part of initialization now runs at app launch, including one request to the CloudX init host that carries no identifiers. Opt out by setting
CloudXStartupWarmDisabledinInfo.plist.
Changed #
- Rewarded ads can pay the reward as soon as the ad network grants it, instead of waiting for the ad to close, so a user who never closes the ad is still rewarded. CloudX turns this on per account. Your
onAdReceivedRewardcallback does not change. - Native SDKs: pins Android
io.cloudx:sdk4.10.0 (from 4.9.0) and iOSCloudXCore3.11.0 (from 3.10.0). Apps inherit every native change in between: Android changelog, iOS changelog. - iOS: rewarded ads now pay the reward amount and currency configured on the ad unit in CloudX, instead of the value the ad network reports.
- iOS: a banner with no refresh interval configured now refreshes every 30 seconds.
- Android, if you enable Magnite:
adapter-magnite1.0.2.1 brings Magnite SDK 1.0.2, which needskotlin-stdlib2.4.0, so your app must compile with Kotlin 2.3 or newer. Kotlin 2.3 removedkotlinOptions; setjvmTargetthroughkotlin { compilerOptions { ... } }. - Android adapters:
adapter-mintegral17.1.81.1 andadapter-pangle8.3.0.4.2 add native, native banner and native MREC ads.adapter-unityads4.21.0.2 fixes Unity Ads initialization never completing in apps that remove Unity'sandroidx.startupinitializer. - Android:
adapter-verve3.9.3.0 brings HyBid SDK 3.9.3, which no longer declares theACCESS_ADSERVICES_TOPICSpermission. - iOS, if you enable Magnite:
CloudXMagniteAdapterV21.0.4.2 fixes a launch crash in apps that set consent before initialization finishes. 1.0.4.0 and 1.0.4.1 are withdrawn. - iOS adapters:
CloudXInMobiAdapter11.5.0.0,CloudXMintegralAdapter8.1.7.0 andCloudXMobileFuseAdapter1.12.0.0 move to InMobi SDK 11.5.0, Mintegral SDK 8.1.7 and MobileFuse SDK 1.12.0, which fixes a crash risk while generating the bidding token.
Fixed #
- Android: CloudX-rendered native ads no longer crash your app when Android's WebView renderer process stops. The ad hides its main image and keeps its text, clicks and impression tracking.
- Android: the SDK no longer crashes on devices where reading the active network fails inside Android itself. It treats that as a normal network error and continues.
- iOS: full-screen HTML ads no longer render at about a third of the screen, and the built-in native templates keep their title and body readable in dark mode.
3.10.0 - 2026-10-08 #
Added #
- Mediation Debugger:
CloudX.showMediationDebugger()opens the native integration screen: every installed adapter with its status, the privacy signals, your ad units and test-ad controls. It returnsfalseuntil initialization completes, so call it afterCloudX.initializesucceeds. CloudXAd.creativeIdcarries the creative identifier the network reported, when it reports one.- BIGO Ads on iOS:
CloudXBigoAdapter6.1.0.0 is published, so BIGO demand is available on both platforms. Copy BIGO'sSKAdNetworkItemsintoInfo.plist, and test on a device: the pod makes the Flutter tool drop arm64 from Simulator builds.
Changed #
- Native SDKs: pins Android
io.cloudx:sdk4.9.0 (from 4.7.0) and iOSCloudXCore3.10.0 (from 3.9.0). Apps inherit every native change in between: Android changelog, iOS changelog. - Ads now honour the advertiser's expiry. On both platforms a fullscreen ad expires with its bid, and showing an expired one fails with error 616. Check readiness before showing, and load a new ad when it fails.
- Inherited on Android: the revenue callback reports realized revenue when the source provides it, MMP connectors skip CloudX wins from bidders that report their own revenue, two Vungle error codes moved, a load during a closing fullscreen ad now completes, and hosts need Kotlin 2.1 or newer.
- Banners on Android: a banner or MREC that fails after it loaded now reports
onAdLoadFailed, and while auto-refresh is stopped the SDK no longer reloads on its own. Callload()for a new ad. - Android startup: WebView and network warm-up now run after the app first reaches the foreground instead of at process start, which lowers ANR risk. Background processes such as FCM and WorkManager skip it.
- Inherited on iOS: a second
initializewaits for the first, test-mode revenue callbacks fire with revenue 0, the revenue callback reports realized revenue, video clicks open the in-app App Store, and clicks fire only on a real tap. - Fullscreen ads on Android: CloudX-rendered interstitial and rewarded ads open in the app's own task, so apps whose launcher Activity sets
android:taskAffinity="", the Flutter template default, no longer get a stuck ad and blocked loads after returning from Home. - iOS privacy manifest: CloudXCore's privacy manifest now declares file-timestamp API use and crash-data collection.
- Digital Turbine on iOS: the docs pin
CloudXDigitalTurbineAdapter8.4.10.0 needs iOS 15.0+ and Xcode 26.1+. The plugin itself still supports iOS 13.0.
Fixed #
- Native ads on dark themes (Android): CloudX native ads in banner and MREC slots now take their text colors from your Activity theme, so titles and body text stay readable.
- HTML ad layout (Android): CloudX-rendered HTML ads with absolutely positioned content are no longer shifted or clipped, and a creative smaller than its slot aligns to the top-left instead of the center.
3.9.0 - 2026-09-11 #
Breaking Changes #
Every item here needs a source change. 3.9.0 is the first release since 2.2.3, and it is deliberately a breaking one.
- Rewarded methods lost the
Adsuffix.loadRewardedAd->loadRewarded,isRewardedAdReady->isRewardedReady,showRewardedAd->showRewarded,destroyRewardedAd->destroyRewarded,setRewardedAdListener->setRewardedListener. Event names are unchanged. - MREC methods are spelled
Mrec.createMREC->createMrec, and the same forloadMrec,showMrec,hideMrec,destroyMrec,startMrecAutoRefresh,stopMrecAutoRefresh,setMrecPlacement,setMrecCustomDataandsetMrecListener. CloudX.initializereturnsCloudXInitializationResult, not a nullableCloudXConfiguration. Replace a null check withif (result.success); the failure carrieserrorCode,errorCodeNameandmessage.CloudXConfigurationis deleted.updateBannerPositionandupdateMrecPositionare gone. Position is fixed at creation. To move an ad view, calldestroyBanner/destroyMrecand create it again at the new position; that starts a new auction.onAdExpandedandonAdCollapsedare gone fromCloudXAdViewListener. Delete those callbacks; the rest are unchanged.CloudX.setVisualDebuggingEnabledis gone. Delete the call. It drove an iOS-only debug overlay and never did anything on Android.CloudXAdViewis no longer exported. The inline widget is unfinished: it takes no placement, custom data or extra parameters, and thesetBanner...setters do not reach it. UsecreateBanner/createMrec, and tell us if you need inline ads.
Fixed #
- A failed
CloudX.initializecan be retried. The result of a failed attempt used to be cached for the life of the process, so a network failure at launch was unrecoverable without a restart. Callinginitializeagain now starts a fresh attempt; a success is still once-only. - A fullscreen show that never reached the SDK now reports a failure. Showing an interstitial or rewarded ad that was never loaded, or with nothing to present from, used to log and return silently, so an app waiting on a callback waited forever.
onAdDisplayFailednow fires.
Added #
- Extra parameters:
setBannerExtraParameter,setMrecExtraParameter,setInterstitialExtraParameterandsetRewardedExtraParameterattach a key and value to that ad unit's auctions. Set them before the load; a value stays until you set the same key again or passnullto clear it. - Load error codes:
loadNotAllowedWhileShowing(303),loadFailed(304) and the concurrency rejection, numbered 305 on Android and 306 on iOS, so the two behaviour changes below can be handled in code. Check both concurrency codes. CloudXError.codeNamecarries the SDK's own name for the code, so a log readsNO_FILL[302]instead of302.CloudXInitializationResult.errorCodeNamedoes the same for an initialization failure.CloudXErrorCode.adNotFound(403) when a show finds no ad for that ad unit, anddisplayHostUnavailable(404) when there is nothing to present from. Both come from the plugin, not the native SDK.
Removed #
- Everything removed in this release is listed under Breaking Changes above, with its migration step.
Changed #
- Native SDKs: pins CloudXCore 3.9.0 on iOS. Android stays on io.cloudx:sdk 4.7.0.
- iOS: a load issued while a fullscreen ad is showing now queues instead of failing. It runs on its own once that ad is dismissed.
LOAD_NOT_ALLOWED_WHILE_SHOWINGis no longer reported on iOS; Android still rejects it. - iOS: at most two of your loads run at once per ad unit. A third fails straight away with a new too-many-concurrent-loads error. Raising the cap is a dashboard setting.
- iOS: fullscreen ads present from the topmost view controller, and a show over system UI such as an alert or a share sheet is refused with the reason in the failure message.
- iOS: revenue callbacks are suppressed in test mode, so sentinel test prices no longer reach your revenue listener.
- iOS: native ad template views size to the creative. A landscape or square creative now returns a taller view whose height follows the width you give it, so read the height rather than assuming 320x250.
3.8.0 - 2026-09-09 #
Added #
- Trusted Arbiter:
CloudX.arbiter(CloudXArbiterConfiguration)compares a loaded CloudX ad with third-party bids and returns the selected platform as aCloudXArbiterResult. Build bids withCloudXArbiterBid.cloudX,.levelPlay,.pubMatic,.adMob,.gamand.custom. - Publisher-reported revenue:
CloudX.reportRevenueData(CloudXRevenueData)forwards impression revenue from another mediation platform (for example AdMob paid events) into CloudX. Required for AdMob and Ad Manager arbiter bids, which CloudX prices from that history. CloudXAd.adValuesexposes the SDK metadata attached to a loaded ad; pass theCloudXAdfromonAdLoadedtoCloudXArbiterBid.cloudXunchanged.
Changed #
CloudXAdFormatis a class, not an enum. An ad format the plugin does not name now arrives with the value the SDK reported, instead of reading asbanner. The constants andadFormat.valueare unchanged; code that treated the type as an enum needs updating.- Native SDKs: pins CloudXCore 3.8.0 (iOS) and io.cloudx:sdk 4.7.0 (Android). Host apps on Android need
compileSdk36 and Kotlin 2.1, inherited from the native SDK. - Adapters version independently: adapters are no longer on the core version. Declare each adapter at its own
<network-sdk-version>.<adapter-revision>from the integration guide; the demo app carries the full set, including Digital Turbine, Pangle, Moloco and Google. - Versioning: the plugin now tracks the iOS
CloudXCoreversion (see Versioning above). Android is pinned separately.
Fixed #
- An ad event whose payload was missing a field or carried an unexpected type used to be dropped before reaching your listener.
CloudXAdnow reports the missing field as absent and delivers the callback.
Removed #
CloudXRendereris no longer published and is no longer referenced. Remove the pod from yourPodfile.
Platform support #
- iOS: CloudXCore 3.8.0
- Android: io.cloudx:sdk 4.7.0
- AdMob Estimated demand (
io.cloudx:adapter-admob) is Android-only; iOS serves Google demand throughCloudXGoogleWaterfallAdapter.
2.2.3 - 2026-03-19 #
Added #
- Manual privacy APIs:
CloudX.setHasUserConsentandCloudX.setDoNotSell(nullablebool?to clear override and defer to CMP signals) - Demo app: Unity Ads mediation via
CloudXUnityAdsAdapter(iOS) andio.cloudx:adapter-unityads(Android) at 2.2.3, alongside existing adapters
Changed #
- Package version aligned with native:
cloudx_flutter2.2.3 pins CloudXCore 2.2.3 and io.cloudx:sdk 2.2.3
Platform support #
- iOS: CloudXCore 2.2.3
- Android: io.cloudx:sdk 2.2.3
Historical: pub package 0.x (native pins varied) #
These versions used 0.x.y for the Dart package only. Native SDK versions are noted per entry.
0.18.0 - 2026-03-18 #
- Added
setHasUserConsent/setDoNotSell - Native 2.2.2 (iOS CloudXCore, Android sdk)
0.17.0 - 2026-03-14 #
- Lowered Dart floor to
>=2.17.1, Flutter to>=3.0.0; removed unusedffi - Native: iOS 2.2.1-beta, Android sdk 2.0.0
0.16.0 - 2026-03-05 #
- First stable pub release; full ad format APIs, listeners, targeting, etc.
- Native: iOS ~> 2.2.0-beta, Android sdk 2.0.0
Ad unit ID migration — 2026-02-21 #
Replaces placement names with Ad Unit IDs from the CloudX dashboard.
Added (at migration) #
- iOS support for all formats; rewarded APIs;
CloudXAdView; targeting APIs;isInitialized; position updates; placement/customData on fullscreen ads;networkPlacement;CloudXErrorCode
Breaking changes (at migration) #
placementName→adUnitIdon create/load APIsCloudXAd.placementName→adUnitId;bidderName→networkName- Removed
isPlatformSupported()
Native SDKs integrate with CMP by default. Optional manual overrides ship in 2.2.3 (see above).