Skip to main content

cloudx_flutter 3.13.0 copy "cloudx_flutter: ^3.13.0" to clipboard
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 send adapterInitializationError (607).

Changed #

  • iOS: the concurrency rejection is 305, as on Android, once the plugin pins an iOS CloudXCore later than 3.13.0. iOS 3.13.0 and earlier send 306. Keep checking both loadRejectedConcurrency (305) and loadRejectedTooManyConcurrentLoads (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 #

  • onExpiredAdReloaded on 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 googleEstimatedEcpm extra parameter through the existing per-format setters, such as setInterstitialExtraParameter. No new API.

Changed #

  • Native SDKs: pins Android io.cloudx:sdk 4.13.0 (from 4.10.0) and iOS CloudXCore 3.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, onAdLoadFailed fires and the ad stops being ready: retries are off by default, so call load() again.
  • isAdReady stays 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: CloudXMobileFuseAdapter 1.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: didHideAd now 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 CloudXStartupWarmDisabled in Info.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 onAdReceivedReward callback does not change.
  • Native SDKs: pins Android io.cloudx:sdk 4.10.0 (from 4.9.0) and iOS CloudXCore 3.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-magnite 1.0.2.1 brings Magnite SDK 1.0.2, which needs kotlin-stdlib 2.4.0, so your app must compile with Kotlin 2.3 or newer. Kotlin 2.3 removed kotlinOptions; set jvmTarget through kotlin { compilerOptions { ... } }.
  • Android adapters: adapter-mintegral 17.1.81.1 and adapter-pangle 8.3.0.4.2 add native, native banner and native MREC ads. adapter-unityads 4.21.0.2 fixes Unity Ads initialization never completing in apps that remove Unity's androidx.startup initializer.
  • Android: adapter-verve 3.9.3.0 brings HyBid SDK 3.9.3, which no longer declares the ACCESS_ADSERVICES_TOPICS permission.
  • iOS, if you enable Magnite: CloudXMagniteAdapterV2 1.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: CloudXInMobiAdapter 11.5.0.0, CloudXMintegralAdapter 8.1.7.0 and CloudXMobileFuseAdapter 1.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 returns false until initialization completes, so call it after CloudX.initialize succeeds.
  • CloudXAd.creativeId carries the creative identifier the network reported, when it reports one.
  • BIGO Ads on iOS: CloudXBigoAdapter 6.1.0.0 is published, so BIGO demand is available on both platforms. Copy BIGO's SKAdNetworkItems into Info.plist, and test on a device: the pod makes the Flutter tool drop arm64 from Simulator builds.

Changed #

  • Native SDKs: pins Android io.cloudx:sdk 4.9.0 (from 4.7.0) and iOS CloudXCore 3.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. Call load() 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 initialize waits 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 CloudXDigitalTurbineAdapter 8.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 Ad suffix. loadRewardedAd -> loadRewarded, isRewardedAdReady -> isRewardedReady, showRewardedAd -> showRewarded, destroyRewardedAd -> destroyRewarded, setRewardedAdListener -> setRewardedListener. Event names are unchanged.
  • MREC methods are spelled Mrec. createMREC -> createMrec, and the same for loadMrec, showMrec, hideMrec, destroyMrec, startMrecAutoRefresh, stopMrecAutoRefresh, setMrecPlacement, setMrecCustomData and setMrecListener.
  • CloudX.initialize returns CloudXInitializationResult, not a nullable CloudXConfiguration. Replace a null check with if (result.success); the failure carries errorCode, errorCodeName and message. CloudXConfiguration is deleted.
  • updateBannerPosition and updateMrecPosition are gone. Position is fixed at creation. To move an ad view, call destroyBanner / destroyMrec and create it again at the new position; that starts a new auction.
  • onAdExpanded and onAdCollapsed are gone from CloudXAdViewListener. Delete those callbacks; the rest are unchanged.
  • CloudX.setVisualDebuggingEnabled is gone. Delete the call. It drove an iOS-only debug overlay and never did anything on Android.
  • CloudXAdView is no longer exported. The inline widget is unfinished: it takes no placement, custom data or extra parameters, and the setBanner... setters do not reach it. Use createBanner / createMrec, and tell us if you need inline ads.

Fixed #

  • A failed CloudX.initialize can 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. Calling initialize again 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. onAdDisplayFailed now fires.

Added #

  • Extra parameters: setBannerExtraParameter, setMrecExtraParameter, setInterstitialExtraParameter and setRewardedExtraParameter attach 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 pass null to 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.codeName carries the SDK's own name for the code, so a log reads NO_FILL[302] instead of 302. CloudXInitializationResult.errorCodeName does the same for an initialization failure.
  • CloudXErrorCode.adNotFound (403) when a show finds no ad for that ad unit, and displayHostUnavailable (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_SHOWING is 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 a CloudXArbiterResult. Build bids with CloudXArbiterBid.cloudX, .levelPlay, .pubMatic, .adMob, .gam and .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.adValues exposes the SDK metadata attached to a loaded ad; pass the CloudXAd from onAdLoaded to CloudXArbiterBid.cloudX unchanged.

Changed #

  • CloudXAdFormat is a class, not an enum. An ad format the plugin does not name now arrives with the value the SDK reported, instead of reading as banner. The constants and adFormat.value are 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 compileSdk 36 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 CloudXCore version (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. CloudXAd now reports the missing field as absent and delivers the callback.

Removed #

  • CloudXRenderer is no longer published and is no longer referenced. Remove the pod from your Podfile.

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 through CloudXGoogleWaterfallAdapter.

2.2.3 - 2026-03-19 #

Added #

  • Manual privacy APIs: CloudX.setHasUserConsent and CloudX.setDoNotSell (nullable bool? to clear override and defer to CMP signals)
  • Demo app: Unity Ads mediation via CloudXUnityAdsAdapter (iOS) and io.cloudx:adapter-unityads (Android) at 2.2.3, alongside existing adapters

Changed #

  • Package version aligned with native: cloudx_flutter 2.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 unused ffi
  • 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 → adUnitId on create/load APIs
  • CloudXAd.placementName → adUnitId; bidderName → networkName
  • Removed isPlatformSupported()

Native SDKs integrate with CMP by default. Optional manual overrides ship in 2.2.3 (see above).

4
likes
140
points
272
downloads

Documentation

Documentation
API reference

Publisher

unverified uploader

Weekly Downloads

Complete Flutter SDK wrapper for CloudX Core with targeting APIs and full ad lifecycle callbacks

Repository (GitHub)
View/report issues

License

MIT (license)

Dependencies

flutter

More

Packages that depend on cloudx_flutter

Packages that implement cloudx_flutter