Skip to main content

nestads_sdk_flutter_plugin 0.2.0 copy "nestads_sdk_flutter_plugin: ^0.2.0" to clipboard
nestads_sdk_flutter_plugin: ^0.2.0 copied to clipboard

Official NestAds SDK for Flutter. Banner, popup, and splash ads with native Android and iOS integration.

Changelog #

Unreleased #

0.2.0 #

  • Production release on the 2.20 native SDK series. Changes below are against 0.1.5.
  • Android: com.nestads:nestads-sdk-android:2.20.2 from https://nexus.wisebirds.ai/repository/releases/ (was 2.13.2).
  • iOS (SPM): nestads-ios-sdk at 2.20.1 from https://github.com/wisebirds/nestads-ios-sdk (was 2.13.1).
  • iOS (CocoaPods): the vendored Frameworks/NestAdsSDK.xcframework is the PRD 2.20.1 build. From 2.19.0 the iOS SDK links its v3 engine, so Frameworks/NestAdsSDK_KMP.xcframework (3.0.1) is vendored next to it (sync via tool/sync-prd-xcframework.sh 2.20.1). SPM apps get the engine through the SDK package.
  • Breaking — minimum iOS 15: the native iOS SDK requires iOS 15 from 2.18.0. Host apps must target iOS 15 or later (was 13).
  • Breaking — FLUID is the default banner size: NestAdsBanner.adSize defaults to NestAdsAdSize.fluid (was NestAdsAdSize(320, 50)). A banner that does not pass adSize takes the parent width and starts at initialHeight (100 by default), then changes height to the creative's aspect ratio when the ad loads, which moves the content below it. Inside a parent with no width limit (a Row, a horizontal ListView), wrap it in Expanded or SizedBox. To keep the old slot, pass adSize: const NestAdsAdSize(320, 50).
  • New: NestAdsBanner forwards partner ad events as onPartnerAdLoaded, onPartnerAdFailedToLoad, onPartnerAdFailedToLoadWithError, onPartnerAdImpression and onPartnerAdClicked. Partner ad groups are tried in the order set in the admin, and Criteo native creatives render with no app changes.
  • New: Moloco RTB partner ads. NestAdsService.initialize(partners: [NestAdsPartnerConfig.moloco(appKey: ...)]) declares the partner, and NestAdsTargeting.rtbPartners picks the partners that bid on each request. The app adds the Moloco partner SDK itself; on iOS it must be NestAdsPartnerMoloco 1.0.1 or later. See README.
  • New: onAdFailedToLoadWithError on banner, popup and splash passes the error code and message as NestAdsAdError.
  • New: NestAdsService.setNightMode(bool isDark) pins banner, popup and splash ads to dark or light creatives. Ads already on screen switch on the next loadAd() on Android and right away on iOS.
  • New: NestAdsBanner.initialHeight sets the height FLUID banners (and FILL banners whose parent height is unbounded) use until the creative size arrives. The default is 100. Pass the placement's creative height (for example 50) so content below does not move when the ad loads. The value must be at least 1.
  • New: NestAdsBanner.onAdClickedWithLandingInfo passes the clicked ad's landing info (NestAdsLandingInfo — url and type) together with onAdClicked. For customLink the SDK does not open the landing page; the app opens url itself.
  • New: NestAdsBannerController.controlPartnerPlayback(command) plays, pauses, mutes or unmutes a partner video ad (for example COVI). replay works on iOS only and stop on Android only. It returns false when the ad on screen has no playback control.
  • New: roadblock ads. NestAdsService.refreshBlockId() issues a new block ID for each screen, getBlockId() returns the current one, and screenType: NestAdsRoadBlockScreenType.singleOnly marks a screen with SINGLE slots only.
  • New: NestAdsSplashOptions.videoQuality (auto · high · medium · low) picks the wide video splash quality. Unset keeps the SDK default (auto).
  • New (Android): NestAdsSplash.onAdClicked and onAdOpened.
  • New: NestAdsPopup width / height can be omitted. With popupMargin* set, the SDK draws the popup inside the margins. Before, the plugin always sent 320, so popupMargin* had no effect.
  • Changed: a controller's loadAd() sends the widget's current targeting. Before, it kept sending the value from when the widget was created.
  • Changed (Android): mediation partner ads (COVI, AdFit) report load and failure through onPartnerAdLoaded / onPartnerAdFailedToLoad / onPartnerAdFailedToLoadWithError. The onAd* callbacks are for direct-sold ads only.
  • Changed (iOS): partner RTB responses the SDK cannot render fail with the partner's code (Moloco 9001, Criteo 9002, Appier 9004).
  • Changed: FIXED banners that show a partner ad (mediation such as AdFit or COVI, Criteo native, partner RTB) take the size the native SDK reports for the ad, as native apps get in a FIXED slot. That size can differ from the FIXED size. A partner RTB banner and a direct-sold ad keep the FIXED size. Before, the slot kept the FIXED size, so a larger ad was cut off and a smaller one left blank space.
  • Changed: image banners may render with the new render engine when the server enables it for the placement.
  • Fix (iOS): NestAdsTargeting.httpTimeoutMillis was ignored and requests always used 1 second.
  • Fix (iOS): apps that turn on Flutter's Swift Package Manager integration (enable-swift-package-manager: true) could not resolve the plugin package. CocoaPods apps were not affected.
  • Fix: when banner, popup and splash were used together, only the format created last got callbacks.
  • Fix: a splash without adSize drew nothing and requested no ad. It now shows at a fixed width × height (360 × 256 by default).
  • Fix: controller.loadAd() called right after the widget was inserted, or right after a banner collapsed by collapseOnFailure expanded again, was dropped.
  • Fix: controller calls such as loadAd() did nothing after the controller was passed to a new widget.
  • Fix: banners and splashes reloaded with controller.loadAd() could miss their impression, and the Android wide splash could fire onAdReachedDuration twice.
  • Fix (Android): controller.loadAd() while a popup was open left the old popup on screen with no way to close it. Both OSes now close the popup first and send onPopupClosed once.
  • Fix: removing the popup widget left the popup or the ad list on screen.
  • Fix (iOS): a popup showed under a full-screen modal.
  • Fix (iOS): a wide splash loaded off screen (Offstage) did not run its timer, impression or video once shown, and a removed or reloaded splash could stay on screen.
  • Fix (iOS): an ad widget inserted before initialize() got no callback. It now fails with the not-initialized error (1000), as on Android.
  • Fix (Android): initialize() called before the Activity attached failed.
  • Fix: a FLUID banner that failed to load left a blank slot (100 high) even without collapseOnFailure.
  • Fix: a FLUID banner left a blank strip below the ad when its parent was wider than the creative.
  • Fix (Android): two-letter country codes ('KR') were recorded as UNKNOWN. They are now converted to three-letter codes, as on iOS.
  • Fix (Android): an audienceParameters value passed as a single value instead of a list was dropped.
  • Fix (iOS): setting any targeting value dropped the app version from the request.
  • Fix (Android): an httpTimeoutMillis of 0 or less, or too large, made requests fail at once. Values outside 1–2147483647 are now ignored and the SDK default is used.
  • Fix: error logs sent through NestAdsErrorReporter were recorded with an empty message, placement and other fields.
  • Fix (iOS): await controller.loadAd() never completed for a removed ad view.
  • Fix (iOS): on foldable iPhones, FLUID / FILL image banners loaded on the unfolded screen used the folded width (iOS SDK 2.18.1).
  • Fix (Android): a wide video splash could crash the app when its thumbnail failed to load (Android SDK 2.20.2).
  • Deprecated (iOS): NestAdsBanner.onAdWillOpen, onAdWillClose and onAdClosed — the native SDK marks their events for removal. They still fire. Use onAdClicked for clicks and WidgetsBindingObserver.didChangeAppLifecycleState for the app returning.
  • Deprecated: NestAdsBanner.onAdFailedToShow. Neither native SDK reports a show failure for banners, so it never fires. It will be removed in the next major version.
  • Other: the default NestAdsEnvironments environment for error logs is now prod (was dev).
  • Other (iOS): banner clicks come from the SDK's new click event. onAdClicked still fires once per click.

0.2.0-dev.4 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production. Native SDKs: Android 2.20.2-SNAPSHOT, iOS 2.20.1-dev (same as 0.2.0-dev.3).
  • iOS: a COVI video in a FIXED slot wider than its parent no longer stops on the play icon. A mediation ad now loads at the parent width, as on the native iOS SDK; it used to load at the FIXED width and then shrink to the parent. An own ad keeps the FIXED width.

0.2.0-dev.3 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production. Native SDKs: Android 2.20.2-SNAPSHOT, iOS 2.20.1-dev (same as 0.2.0-dev.2).
  • Native SDK (Android): com.nestads:nestads-sdk-android:2.20.2-SNAPSHOT (was 2.20.1-SNAPSHOT). The commented PRD line points at 2.20.2. 2.20.2 is 2.20.1 plus one fix: when a wide video splash thumbnail fails to load (a timeout or a 404), the app no longer crashes; the splash shows without the thumbnail. iOS stays at 2.20.1-dev: the iOS SDK has no 2.20.2 and hides a thumbnail that fails to load.

0.2.0-dev.2 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production. Native SDKs: Android 2.20.1-SNAPSHOT, iOS 2.20.1-dev (same as 0.2.0-dev.1).
  • New: NestAdsBanner.onAdClickedWithLandingInfo passes the clicked ad's landing info (NestAdsLandingInfo — url and type: inlink · outlink · customLink). It fires together with onAdClicked. For customLink the native SDK does not open the landing page; the app opens url itself (native SDK 2.14.0 or later). landingInfo is null when the SDK gives none.
  • New: NestAdsBannerController.controlPartnerPlayback(command) plays, pauses, mutes or unmutes a partner video ad (for example COVI) shown in the banner. replay works on iOS only and stop on Android only. It returns false when the ad on screen has no playback control.
  • New: roadblock. NestAdsService.refreshBlockId() issues a new block ID: call it once each time a screen opens, before that screen's ad requests, and again when the screen refreshes its ads (pull-to-refresh), except on a linked sub screen, where a second call breaks the link to the main screen. Not per ad view. screenType: NestAdsRoadBlockScreenType.singleOnly marks a screen with SINGLE roadblock slots only; without it, such a screen opened right after a linked main screen shows no SINGLE ads, held back by the previous screen's linked state. Do not pass it on linked main or sub screens, or on screens that mix sub and SINGLE slots: it breaks the link and the linked ads are not shown. NestAdsService.getBlockId() returns the current block ID.
  • New: NestAdsSplashOptions.videoQuality (NestAdsVideoQuality.auto · high · medium · low) picks the wide video splash quality. Unset keeps the SDK default (auto).
  • iOS: banner clicks now come from the SDK's imageBannerAdViewDidClick(_:isLogSent:landingInfo:) instead of the deprecated imageBannerAdViewDidClickWithLogStatus. onAdClicked still fires once per click.

0.2.0-dev.1 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production. Native SDKs: Android 2.20.1-SNAPSHOT, iOS 2.20.1-dev (below).
  • Breaking — FLUID is the default banner size: NestAdsBanner.adSize now defaults to NestAdsAdSize.fluid. It was NestAdsAdSize(320, 50) (FIXED). A banner that does not pass adSize now takes the parent width and a height from the creative's aspect ratio: it starts at initialHeight (100 by default) and changes height when the ad loads, which moves the content below it. Inside a parent with no width limit (a Row, a horizontal ListView), wrap it in Expanded or SizedBox; debug builds assert otherwise. To keep the old slot, pass adSize: const NestAdsAdSize(320, 50).
  • Native SDKs: Android com.nestads:nestads-sdk-android:2.20.1-SNAPSHOT (was 2.18.0-SNAPSHOT), iOS (SPM) nestads-sdk-ios-package 2.20.1-dev (was 2.18.1-dev). The commented PRD lines point at 2.20.1.
  • iOS (CocoaPods): from 2.19.0 the iOS SDK links its v3 engine NestAdsSDK_KMP.framework, so the plugin now vendors Frameworks/NestAdsSDK_KMP.xcframework (the DEV 3.0.1 build) next to the DEV 2.20.1 Frameworks/NestAdsSDK.xcframework. tool/sync-dev-xcframework.sh / tool/sync-prd-xcframework.sh fetch both from the SDK package manifests and check release zips against the manifest checksum; they need iOS SDK 2.19.0 or later. SPM apps get the engine through the SDK package and need nothing new.
  • Behavior changes from the native SDKs:
    • Android: mediation partner ads (COVI, AdFit) now report load and failure through onPartnerAdLoaded / onPartnerAdFailedToLoad / onPartnerAdFailedToLoadWithError, not onAdLoaded / onAdFailedToLoad / onAdFailedToLoadWithError (Android SDK 2.20.1). The onAd* callbacks are for direct-sold ads only.
    • Android: FLUID banners, and FILL banners whose parent height is unbounded, that show a mediation ad (COVI, AdFit) now grow to fit the ad. Before, they were no taller than initialHeight (100 by default).
    • iOS: Moloco RTB ads need NestAdsPartnerMoloco 1.0.1 or later in the Runner target; with 1.0.0 the SDK skips Moloco ads. Partner RTB responses the SDK cannot render now fail with the partner's code (Moloco 9001, Criteo 9002, Appier 9004) instead of 3000.
    • Android: when a FLUID banner's width changes after it loads (rotation, split screen, a layout that widens or narrows it), the banner height now follows the creative, as on iOS. Before, it kept the height from the load.
    • iOS: the native SDK marks the events behind NestAdsBanner.onAdWillOpen, onAdWillClose and onAdClosed for removal, so the three callbacks are now deprecated. They still fire. Use onAdClicked for clicks and WidgetsBindingObserver.didChangeAppLifecycleState for the app becoming active (onAdClosed) or returning to the foreground (onAdWillClose).
    • Both: partner RTB and mediation ad groups are tried in the order set in the admin, and Criteo native creatives render with no app changes (2.20.0 / 2.20.1). Image banners may render with the new render engine when the server enables it for the placement (2.19.0).
  • FIXED banners that show a partner ad (mediation such as AdFit or COVI, Criteo native, partner RTB) now take the size the native SDK reports for the ad, as native apps get in a FIXED slot. That size can differ from the FIXED size: a mediation ad's size depends on the partner ad (an AdFit native card on iOS, for example, is taller), and a Criteo native ad takes the FIXED width (no wider than the screen) and the height its layout needs. A partner RTB banner and a direct-sold ad keep the FIXED size. Before, the slot kept the FIXED size, so a taller ad was cut off and a shorter one left blank space.
  • Deprecated (shipped in 0.1.6-dev.3 but missing from its changelog): NestAdsBanner.onAdFailedToShow. Neither native SDK reports a show failure for banners, so it never fires. It will be removed in the next major version. Apps that pass it to NestAdsBanner(...) now get the deprecation warning; in 0.1.6-dev.3 they saw none.
  • New: NestAdsBanner.initialHeight sets the slot height that FLUID banners (and FILL banners whose parent height is unbounded) use until the native SDK reports the creative size. The default is 100, as before. When a placement serves a single creative height, pass that height (for example 50 for 320×50 creatives) so content below the banner does not shift when the ad loads. The value must be at least 1: Flutter does not create an Android platform view with zero height, so the ad would never be requested. Debug builds assert; release builds use 1.

0.1.6-dev.3 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production. Native SDKs unchanged from 0.1.6-dev.2 (Android 2.18.0-SNAPSHOT, iOS 2.18.1-dev).
  • New: Moloco RTB partner ads. NestAdsService.initialize(partners: [NestAdsPartnerConfig.moloco(appKey: ...)]) declares the partner, and NestAdsTargeting.rtbPartners picks the partners that bid on each request. The app adds the Moloco partner SDK itself, the same as with the native SDKs: Android Gradle dependency plus the AndroidManifest app key, iOS Swift package NestAdsPartnerMoloco in the Runner target. See README.
  • Fix (Android): AdFit mediation ads now load. The banner view used Flutter's wrapped context (and, after setNightMode, a night-mode wrapper), and the AdFit SDK rejects anything but an Activity — every AdFit ad failed with 9003 Context must be Activity context!. The banner view now gets the Activity itself; dark or light creatives still follow setNightMode through loadAd.
  • Fix (iOS): NestAdsTargeting.httpTimeoutMillis now sets the ad request timeout. Before, the plugin always passed 1 second to the iOS SDK and ignored the value.
  • Fix: iOS apps that turn on Flutter's Swift Package Manager integration (enable-swift-package-manager: true) failed to resolve the plugin package — the target pointed outside the package root (../Classes) and the library product was named nestads-flutter-plugin instead of the nestads-sdk-flutter-plugin Flutter looks for. iOS sources now live in ios/nestads_sdk_flutter_plugin/Sources/nestads_sdk_flutter_plugin/; CocoaPods apps are unaffected.

0.1.6-dev.2 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production. Native SDKs unchanged from 0.1.6-dev.1 (Android 2.18.0-SNAPSHOT, iOS 2.18.1-dev).
  • New (shipped in 0.1.6-dev.1 but missing from its changelog): NestAdsService.setNightMode(bool isDark) pins banner / popup / splash views to dark or light ad creatives. Ad views created after the call use it; views already on screen pick it up when they are recreated.
  • Fix: when the host never calls setNightMode, ad views follow the system dark mode again. In 0.1.6-dev.1 they were pinned to light by default, so dark creatives never showed unless the host called setNightMode(true).
  • Fix (Android): popups show again after setNightMode. In 0.1.6-dev.1 the night-mode context was cut off from the Activity, so the popup dialog had no window and threw BadTokenException.
  • New: NestAdsBanner forwards partner ad events (Criteo, Appier, …) as onPartnerAdLoaded, onPartnerAdFailedToLoad, onPartnerAdImpression and onPartnerAdClicked. The native SDKs report these apart from the direct-sold callbacks, and the plugin did not listen to them before. Partner loads resize FLUID / FILL slots and partner failures honour collapseOnFailure, the same as direct-sold ads.

0.1.6-dev.1 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production.
  • Android: com.nestads:nestads-sdk-android:2.18.0-SNAPSHOT from https://nexus.wisebirds.ai/repository/snapshots/.
  • iOS (SPM): nestads-sdk-ios-package at 2.18.1-dev from https://bitbucket.org/wisebirds/nestads-sdk-ios-package.
  • iOS (CocoaPods): the vendored Frameworks/NestAdsSDK.xcframework is the DEV 2.18.1 build (sync via tool/sync-dev-xcframework.sh 2.18.1-dev).
  • Breaking — minimum iOS 15: the native iOS SDK requires iOS 15 from 2.18.0. The podspec platform and Package.swift platform are raised from iOS 13 to iOS 15; host apps must target iOS 15 or later.
  • Fix (iOS): on foldable iPhones (iPhone Duo), FLUID / FILL image banners loaded on the unfolded screen now use the full window width instead of being capped at the folded width (iOS SDK 2.18.1, WP-11103).
  • Android: NestAdsAdListener.onAdClicked takes a new landingInfo: NestAdsLandingInfo? parameter since native SDK 2.17.0. Banner and splash factories are updated to the new signature. landingInfo is not forwarded to Dart on either platform yet, so CUSTOMLINK landings are not handled by the plugin.

0.1.5 #

  • Production release on the 2.13 native SDK series.
  • Android: com.nestads:nestads-sdk-android:2.13.2 from https://nexus.wisebirds.ai/repository/releases/.
  • iOS (SPM): nestads-ios-sdk at 2.13.1 from https://github.com/wisebirds/nestads-ios-sdk.
  • iOS (CocoaPods): the vendored Frameworks/NestAdsSDK.xcframework is the PRD 2.13.1 build (sync via tool/sync-prd-xcframework.sh 2.13.1).
  • Breaking — typed NestAdsTargeting: the free-form targeting: Map<String, dynamic>? parameter on NestAdsBanner / NestAdsPopup is replaced with targeting: NestAdsTargeting?. The new class exposes typed fields (country, language, gender, age, publisherProvidedId, customTargeting, audienceParameters, plus platform-specific appVersion iOS-only / httpTimeoutMillis Android-only). Wire format (Map of the same keys) is unchanged so native factories are unaffected.
  • New: NestAdsGender { unknown, male, female } enum on NestAdsTargeting.gender (replaces magic int / string values).
  • New: NestAdsSplash now exposes targeting: NestAdsTargeting? — previously the widget had no way to forward targeting even though the native factories already supported it.

0.1.5-dev.2 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production.
  • Breaking — typed NestAdsTargeting: the free-form targeting: Map<String, dynamic>? parameter on NestAdsBanner / NestAdsPopup is replaced with targeting: NestAdsTargeting?. The new class exposes typed fields (country, language, gender, age, publisherProvidedId, customTargeting, audienceParameters, plus platform-specific appVersion iOS-only / httpTimeoutMillis Android-only). Wire format (Map of the same keys) is unchanged so native factories are unaffected.
  • New: NestAdsGender { unknown, male, female } enum on NestAdsTargeting.gender (replaces magic int / string values from the old Map).
  • New: NestAdsSplash now exposes targeting: NestAdsTargeting? — previously the widget had no way to forward targeting even though the native factories already supported it.

0.1.5-dev.1 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production.
  • Android: com.nestads:nestads-sdk-android:2.13.2-SNAPSHOT from https://nexus.wisebirds.ai/repository/snapshots/.
  • iOS (SPM): nestads-sdk-ios-package at 2.13.1-dev from https://bitbucket.org/wisebirds/nestads-sdk-ios-package.
  • iOS (CocoaPods): the vendored Frameworks/NestAdsSDK.xcframework is the DEV 2.13.1 build (sync via tool/sync-dev-xcframework.sh 2.13.1-dev after each native SDK bump).
  • New: NestAdsBanner.collapseOnFailure — when true, the slot collapses to SizedBox.shrink after onAdFailedToLoad and re-expands automatically when the host calls controller.loadAd().
  • New: loadMode: NestAdsLoadMode.auto | .manual on banner / popup / splash widgets — manual skips the implicit initial load so the host can trigger it via controller.loadAd() (mirrors the nestads-sdk-kmp <nestads-ad load-mode> web component convention).
  • New: NestAdsPopupOptions.backgroundType (Android only) — selects whether the server-provided background color or the backgroundColor field wins (AUTO vs CUSTOM). iOS has no equivalent and silently ignores the field.
  • Internal: shared parser utilities (PluginUtils.kt / PluginUtils.swift) consolidate duplicate parseInt / parseDouble / parseBool / findLifecycleOwner / parseAdSize / parseBackgroundType helpers across all factories.
  • Internal: dead code cleanup — removed unused findImageView / collectLargestImageView from iOS banner factory; banner now uses intrinsicContentSize for all ad sizes. Removed unused logToDart from iOS banner / popup factories.

0.1.4 #

  • First production release on the 2.13 native SDK series.
  • Android: com.nestads:nestads-sdk-android:2.13.2 from https://nexus.wisebirds.ai/repository/releases/.
  • iOS (SPM): nestads-ios-sdk at 2.13.1 from https://github.com/wisebirds/nestads-ios-sdk.
  • iOS (CocoaPods): the vendored Frameworks/NestAdsSDK.xcframework is the PRD 2.13.1 build (sync via tool/sync-prd-xcframework.sh 2.13.1).
  • Breaking — splash unified: NestAdsWideSplash widget / controller / options removed. The single NestAdsSplash widget now handles both legacy SPLASH and wide (image / video) responses; the native side routes by response type. Wide-only callbacks (onBackgroundColorReady, onVideoStarted, etc.) are exposed on the same widget.
  • Breaking — popup button options grouped: 8 flat left/rightButton{FontName,FontColor,Color,BorderColor} fields collapsed into typed NestAdsPopupButtonOptions referenced as leftButton / rightButton. Wire format unchanged so native factories are unaffected.
  • Breaking — explicit SDK initialization: native auto-init removed from plugin attach (Android) and registration (iOS). Host apps must call NestAdsService.initialize() (or initializeIgnoringErrors()) before mounting any ad widget.
  • Breaking — NestAdsAdSize.fluidContain removed: native banner / splash factories already auto-route Dart FLUID to the SDK's FLUID_CONTAIN (Android 2.13.1+ / iOS NestAdsSizeType.fluidContain), so exposing both was redundant. Wire format simplifies to 'FLUID' / 'FILL' / 'FIXED'. The isFluidContain getter is removed.
  • New: typed NestAdsBannerOptions (replaces free-form Map), NestAdsBackgroundType enum.
  • New: NestAdsBanner.collapseOnFailure — when true, the slot collapses to SizedBox.shrink after onAdFailedToLoad and re-expands automatically when the host calls controller.loadAd().
  • New: loadMode: NestAdsLoadMode.auto | .manual on banner / popup / splash widgets — manual skips the implicit initial load so the host can trigger it via controller.loadAd() (mirrors the nestads-sdk-kmp <nestads-ad load-mode> web component convention).
  • New: NestAdsErrorReporter utility for reporting host-callback exceptions, plus a NestAdsEnvironment config. Plugin gains crypto, encrypt, http runtime deps.
  • Android: unified splash factory under a single NestAdsSplashViewFactory (the wide factory file removed). Lifecycle-owner propagation via findViewTreeLifecycleOwner so platform-view ad views get visibility-tracked impressions.
  • Banner / popup / splash: host-callback dispatch wrapped in try/catch so a throwing consumer callback no longer wedges the method channel.
  • Internal: shared parser utilities (PluginUtils.kt / PluginUtils.swift) consolidate duplicate parseInt / parseDouble / parseBool / findLifecycleOwner / parseAdSize helpers across all factories.

0.1.4-dev.2 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production.
  • Breaking — NestAdsAdSize.fluidContain removed: native banner / splash factories already auto-route Dart FLUID to SDK FLUID_CONTAIN (Android 2.13.1+ / iOS NestAdsSizeType.fluidContain), so exposing both was redundant and confusing. Picking fluidContain explicitly never produced different behavior than fluid. The wire format simplifies to 'FLUID' / 'FILL' / 'FIXED'. The isFluidContain getter is removed accordingly.
  • iOS splash factory: removed dead case "FLUID_CONTAIN" branch (no longer reachable since Dart can't produce that wire string).

0.1.4-dev.1 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production.
  • Android: com.nestads:nestads-sdk-android:2.13.2-SNAPSHOT (unchanged).
  • iOS (SPM): nestads-sdk-ios-package at 2.13.1-dev (unchanged).
  • Breaking — splash unified: NestAdsWideSplash widget / controller / options removed. The single NestAdsSplash widget now handles both legacy SPLASH and wide (image / video) responses; the native side routes by response type.
  • Breaking — popup button options grouped: 8 flat left/rightButton{FontName,FontColor,Color,BorderColor} fields collapsed into typed NestAdsPopupButtonOptions referenced as leftButton / rightButton. Wire format unchanged so native factories are unaffected.
  • Breaking — explicit SDK initialization: native auto-init removed from plugin attach (Android) and registration (iOS). Host apps must call NestAdsService.initialize() (or initializeIgnoringErrors()) before mounting any ad widget.
  • NestAdsAdSize is now backed by a NestAdsAdSizeType enum internally — wire format ('FLUID' / 'FILL' / 'FIXED') preserved. The Dart fluidContain value has been removed: native factories already auto-route FLUID → SDK FLUID_CONTAIN on platforms that support it, so exposing both was redundant.
  • Banner: typed NestAdsBannerOptions (was free-form Map). Adds NestAdsBackgroundType enum.
  • Android: unified splash factory under a single NestAdsSplashViewFactory (the wide factory file removed).
  • New: NestAdsErrorReporter utility for reporting host-callback exceptions, plus a NestAdsEnvironment config. Plugin gains crypto, encrypt, http runtime deps.
  • Banner: host-callback dispatch wrapped in try/catch so a throwing consumer callback no longer wedges the method channel.

0.1.3-dev.1 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production.
  • Android: com.nestads:nestads-sdk-android:2.13.2-SNAPSHOT from https://nexus.wisebirds.ai/repository/snapshots/.
  • iOS (SPM): nestads-sdk-ios-package at 2.13.1-dev from https://bitbucket.org/wisebirds/nestads-sdk-ios-package.
  • iOS (CocoaPods): the vendored Frameworks/NestAdsSDK.xcframework is the DEV 2.13.1 build (sync via tool/sync-dev-xcframework.sh 2.13.1-dev after each native SDK bump).
  • Splash: split simple/wide cleanly — NestAdsSplash is image-only on both platforms (no video callbacks/options); video belongs to NestAdsWideSplash.
  • Android: lifecycle-owner propagation via findViewTreeLifecycleOwner so platform-view ad views get visibility-tracked impressions.

0.1.2-dev.2 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production.
  • Android: com.nestads:nestads-sdk-android:2.13.1-SNAPSHOT from https://nexus.wisebirds.ai/repository/snapshots/.
  • iOS (SPM): nestads-sdk-ios-package at 2.13.0-dev from https://bitbucket.org/wisebirds/nestads-sdk-ios-package.
  • iOS (CocoaPods): the vendored Frameworks/NestAdsSDK.xcframework is the DEV 2.13.0 build (sync via tool/sync-dev-xcframework.sh 2.13.0-dev after each native SDK bump).
  • Banner: routes Dart NestAdsAdSize.fluid to native FLUID_CONTAIN (Android 2.13.1+) / NestAdsSizeType.fluidContain (iOS), giving aspect-correct fluid sizing at parent width.
  • Banner: ATT request and smart-quote normalization for JSON targeting fields.
  • Layout: top-level tools/ directory renamed to tool/ per pub layout convention.

0.1.2 #

  • DEV build of nestads_sdk_flutter_plugin. Not for production.
  • Android: com.nestads:nestads-sdk-android:2.13.0-SNAPSHOT from https://nexus.wisebirds.ai/repository/snapshots/.
  • iOS (SPM): nestads-sdk-ios-package at 2.13.0-dev from https://bitbucket.org/wisebirds/nestads-sdk-ios-package.
  • iOS (CocoaPods): the vendored Frameworks/NestAdsSDK.xcframework is the DEV 2.13.0 build (sync via tool/sync-dev-xcframework.sh 2.13.0-dev after each native SDK bump).

0.1.1 #

  • Bundle iOS NestAdsSDK.xcframework 2.11.0 (was stale in 0.1.0 — caused BackgroundBehavior/VideoPlayCondition unresolved errors on CocoaPods install).

0.1.0 — Initial release #

  • Banner ads (NestAdsBanner) with FIXED / FLUID / FILL sizing
  • Popup ads (NestAdsPopup) with show/dismiss controls
  • Splash ads (NestAdsSplash) — image + video (iOS v2.11.0+)
  • Wide splash ads (NestAdsWideSplash) — Android only, full-screen
  • Imperative controllers (NestAds<Format>Controller) with loadAd() + generic invoke()
  • Typed options classes (NestAds<Format>Options) for format-specific config
  • Bundled native SDKs: Android com.nestads:nestads-sdk-android:2.11.0, iOS SPM wisebirds/nestads-ios-sdk:2.11.0
0
likes
135
points
964
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Official NestAds SDK for Flutter. Banner, popup, and splash ads with native Android and iOS integration.

Homepage
Repository
View/report issues

License

MIT (license)

Dependencies

crypto, encrypt, flutter, http, visibility_detector

More

Packages that depend on nestads_sdk_flutter_plugin

Packages that implement nestads_sdk_flutter_plugin