nestads_sdk_flutter_plugin 0.2.0
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.2fromhttps://nexus.wisebirds.ai/repository/releases/(was 2.13.2). - iOS (SPM):
nestads-ios-sdkat2.20.1fromhttps://github.com/wisebirds/nestads-ios-sdk(was 2.13.1). - iOS (CocoaPods): the vendored
Frameworks/NestAdsSDK.xcframeworkis the PRD2.20.1build. From 2.19.0 the iOS SDK links its v3 engine, soFrameworks/NestAdsSDK_KMP.xcframework(3.0.1) is vendored next to it (sync viatool/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.adSizedefaults toNestAdsAdSize.fluid(wasNestAdsAdSize(320, 50)). A banner that does not passadSizetakes the parent width and starts atinitialHeight(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 (aRow, a horizontalListView), wrap it inExpandedorSizedBox. To keep the old slot, passadSize: const NestAdsAdSize(320, 50). - New:
NestAdsBannerforwards partner ad events asonPartnerAdLoaded,onPartnerAdFailedToLoad,onPartnerAdFailedToLoadWithError,onPartnerAdImpressionandonPartnerAdClicked. 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, andNestAdsTargeting.rtbPartnerspicks the partners that bid on each request. The app adds the Moloco partner SDK itself; on iOS it must beNestAdsPartnerMoloco1.0.1 or later. See README. - New:
onAdFailedToLoadWithErroron banner, popup and splash passes the error code and message asNestAdsAdError. - New:
NestAdsService.setNightMode(bool isDark)pins banner, popup and splash ads to dark or light creatives. Ads already on screen switch on the nextloadAd()on Android and right away on iOS. - New:
NestAdsBanner.initialHeightsets 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 example50) so content below does not move when the ad loads. The value must be at least 1. - New:
NestAdsBanner.onAdClickedWithLandingInfopasses the clicked ad's landing info (NestAdsLandingInfo—urlandtype) together withonAdClicked. ForcustomLinkthe SDK does not open the landing page; the app opensurlitself. - New:
NestAdsBannerController.controlPartnerPlayback(command)plays, pauses, mutes or unmutes a partner video ad (for example COVI).replayworks on iOS only andstopon Android only. It returnsfalsewhen 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, andscreenType: NestAdsRoadBlockScreenType.singleOnlymarks 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.onAdClickedandonAdOpened. - New:
NestAdsPopupwidth/heightcan be omitted. WithpopupMargin*set, the SDK draws the popup inside the margins. Before, the plugin always sent 320, sopopupMargin*had no effect. - Changed: a controller's
loadAd()sends the widget's currenttargeting. 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. TheonAd*callbacks are for direct-sold ads only. - Changed (iOS): partner RTB responses the SDK cannot render fail with the partner's code (Moloco
9001, Criteo9002, Appier9004). - 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.httpTimeoutMilliswas 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
adSizedrew nothing and requested no ad. It now shows at a fixedwidth×height(360 × 256 by default). - Fix:
controller.loadAd()called right after the widget was inserted, or right after a banner collapsed bycollapseOnFailureexpanded 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 fireonAdReachedDurationtwice. - 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 sendonPopupClosedonce. - 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 asUNKNOWN. They are now converted to three-letter codes, as on iOS. - Fix (Android): an
audienceParametersvalue 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
httpTimeoutMillisof 0 or less, or too large, made requests fail at once. Values outside1–2147483647are now ignored and the SDK default is used. - Fix: error logs sent through
NestAdsErrorReporterwere 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,onAdWillCloseandonAdClosed— the native SDK marks their events for removal. They still fire. UseonAdClickedfor clicks andWidgetsBindingObserver.didChangeAppLifecycleStatefor 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
NestAdsEnvironmentsenvironment for error logs is nowprod(wasdev). - Other (iOS): banner clicks come from the SDK's new click event.
onAdClickedstill 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.onAdClickedWithLandingInfopasses the clicked ad's landing info (NestAdsLandingInfo—urlandtype:inlink·outlink·customLink). It fires together withonAdClicked. ForcustomLinkthe native SDK does not open the landing page; the app opensurlitself (native SDK 2.14.0 or later).landingInfois 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.replayworks on iOS only andstopon Android only. It returnsfalsewhen 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.singleOnlymarks 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 deprecatedimageBannerAdViewDidClickWithLogStatus.onAdClickedstill 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.adSizenow defaults toNestAdsAdSize.fluid. It wasNestAdsAdSize(320, 50)(FIXED). A banner that does not passadSizenow takes the parent width and a height from the creative's aspect ratio: it starts atinitialHeight(100 by default) and changes height when the ad loads, which moves the content below it. Inside a parent with no width limit (aRow, a horizontalListView), wrap it inExpandedorSizedBox; debug builds assert otherwise. To keep the old slot, passadSize: 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-package2.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 vendorsFrameworks/NestAdsSDK_KMP.xcframework(the DEV 3.0.1 build) next to the DEV 2.20.1Frameworks/NestAdsSDK.xcframework.tool/sync-dev-xcframework.sh/tool/sync-prd-xcframework.shfetch 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, notonAdLoaded/onAdFailedToLoad/onAdFailedToLoadWithError(Android SDK 2.20.1). TheonAd*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
NestAdsPartnerMoloco1.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 (Moloco9001, Criteo9002, Appier9004) instead of3000. - 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,onAdWillCloseandonAdClosedfor removal, so the three callbacks are now deprecated. They still fire. UseonAdClickedfor clicks andWidgetsBindingObserver.didChangeAppLifecycleStatefor 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).
- Android: mediation partner ads (COVI, AdFit) now report load and failure through
- 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 toNestAdsBanner(...)now get the deprecation warning; in 0.1.6-dev.3 they saw none. - New:
NestAdsBanner.initialHeightsets 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 is100, as before. When a placement serves a single creative height, pass that height (for example50for 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, andNestAdsTargeting.rtbPartnerspicks 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 packageNestAdsPartnerMolocoin 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 with9003 Context must be Activity context!. The banner view now gets the Activity itself; dark or light creatives still followsetNightModethroughloadAd. - Fix (iOS):
NestAdsTargeting.httpTimeoutMillisnow 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 namednestads-flutter-plugininstead of thenestads-sdk-flutter-pluginFlutter looks for. iOS sources now live inios/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 calledsetNightMode(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 threwBadTokenException. - New:
NestAdsBannerforwards partner ad events (Criteo, Appier, …) asonPartnerAdLoaded,onPartnerAdFailedToLoad,onPartnerAdImpressionandonPartnerAdClicked. 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 honourcollapseOnFailure, 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-SNAPSHOTfromhttps://nexus.wisebirds.ai/repository/snapshots/. - iOS (SPM):
nestads-sdk-ios-packageat2.18.1-devfromhttps://bitbucket.org/wisebirds/nestads-sdk-ios-package. - iOS (CocoaPods): the vendored
Frameworks/NestAdsSDK.xcframeworkis the DEV2.18.1build (sync viatool/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.swiftplatform 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.onAdClickedtakes a newlandingInfo: NestAdsLandingInfo?parameter since native SDK 2.17.0. Banner and splash factories are updated to the new signature.landingInfois 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.2fromhttps://nexus.wisebirds.ai/repository/releases/. - iOS (SPM):
nestads-ios-sdkat2.13.1fromhttps://github.com/wisebirds/nestads-ios-sdk. - iOS (CocoaPods): the vendored
Frameworks/NestAdsSDK.xcframeworkis the PRD2.13.1build (sync viatool/sync-prd-xcframework.sh 2.13.1). - Breaking — typed
NestAdsTargeting: the free-formtargeting: Map<String, dynamic>?parameter onNestAdsBanner/NestAdsPopupis replaced withtargeting: NestAdsTargeting?. The new class exposes typed fields (country,language,gender,age,publisherProvidedId,customTargeting,audienceParameters, plus platform-specificappVersioniOS-only /httpTimeoutMillisAndroid-only). Wire format (Map of the same keys) is unchanged so native factories are unaffected. - New:
NestAdsGender { unknown, male, female }enum onNestAdsTargeting.gender(replaces magic int / string values). - New:
NestAdsSplashnow exposestargeting: 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-formtargeting: Map<String, dynamic>?parameter onNestAdsBanner/NestAdsPopupis replaced withtargeting: NestAdsTargeting?. The new class exposes typed fields (country,language,gender,age,publisherProvidedId,customTargeting,audienceParameters, plus platform-specificappVersioniOS-only /httpTimeoutMillisAndroid-only). Wire format (Map of the same keys) is unchanged so native factories are unaffected. - New:
NestAdsGender { unknown, male, female }enum onNestAdsTargeting.gender(replaces magic int / string values from the old Map). - New:
NestAdsSplashnow exposestargeting: 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-SNAPSHOTfromhttps://nexus.wisebirds.ai/repository/snapshots/. - iOS (SPM):
nestads-sdk-ios-packageat2.13.1-devfromhttps://bitbucket.org/wisebirds/nestads-sdk-ios-package. - iOS (CocoaPods): the vendored
Frameworks/NestAdsSDK.xcframeworkis the DEV2.13.1build (sync viatool/sync-dev-xcframework.sh 2.13.1-devafter each native SDK bump). - New:
NestAdsBanner.collapseOnFailure— whentrue, the slot collapses toSizedBox.shrinkafteronAdFailedToLoadand re-expands automatically when the host callscontroller.loadAd(). - New:
loadMode: NestAdsLoadMode.auto | .manualon banner / popup / splash widgets —manualskips the implicit initial load so the host can trigger it viacontroller.loadAd()(mirrors thenestads-sdk-kmp<nestads-ad load-mode>web component convention). - New:
NestAdsPopupOptions.backgroundType(Android only) — selects whether the server-provided background color or thebackgroundColorfield wins (AUTOvsCUSTOM). iOS has no equivalent and silently ignores the field. - Internal: shared parser utilities (
PluginUtils.kt/PluginUtils.swift) consolidate duplicateparseInt/parseDouble/parseBool/findLifecycleOwner/parseAdSize/parseBackgroundTypehelpers across all factories. - Internal: dead code cleanup — removed unused
findImageView/collectLargestImageViewfrom iOS banner factory; banner now usesintrinsicContentSizefor all ad sizes. Removed unusedlogToDartfrom 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.2fromhttps://nexus.wisebirds.ai/repository/releases/. - iOS (SPM):
nestads-ios-sdkat2.13.1fromhttps://github.com/wisebirds/nestads-ios-sdk. - iOS (CocoaPods): the vendored
Frameworks/NestAdsSDK.xcframeworkis the PRD2.13.1build (sync viatool/sync-prd-xcframework.sh 2.13.1). - Breaking — splash unified:
NestAdsWideSplashwidget / controller / options removed. The singleNestAdsSplashwidget 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 typedNestAdsPopupButtonOptionsreferenced asleftButton/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()(orinitializeIgnoringErrors()) before mounting any ad widget. - Breaking —
NestAdsAdSize.fluidContainremoved: native banner / splash factories already auto-route DartFLUIDto the SDK'sFLUID_CONTAIN(Android 2.13.1+ / iOSNestAdsSizeType.fluidContain), so exposing both was redundant. Wire format simplifies to'FLUID'/'FILL'/'FIXED'. TheisFluidContaingetter is removed. - New: typed
NestAdsBannerOptions(replaces free-formMap),NestAdsBackgroundTypeenum. - New:
NestAdsBanner.collapseOnFailure— whentrue, the slot collapses toSizedBox.shrinkafteronAdFailedToLoadand re-expands automatically when the host callscontroller.loadAd(). - New:
loadMode: NestAdsLoadMode.auto | .manualon banner / popup / splash widgets —manualskips the implicit initial load so the host can trigger it viacontroller.loadAd()(mirrors thenestads-sdk-kmp<nestads-ad load-mode>web component convention). - New:
NestAdsErrorReporterutility for reporting host-callback exceptions, plus aNestAdsEnvironmentconfig. Plugin gainscrypto,encrypt,httpruntime deps. - Android: unified splash factory under a single
NestAdsSplashViewFactory(the wide factory file removed). Lifecycle-owner propagation viafindViewTreeLifecycleOwnerso 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 duplicateparseInt/parseDouble/parseBool/findLifecycleOwner/parseAdSizehelpers across all factories.
0.1.4-dev.2 #
- DEV build of
nestads_sdk_flutter_plugin. Not for production. - Breaking —
NestAdsAdSize.fluidContainremoved: native banner / splash factories already auto-route DartFLUIDto SDKFLUID_CONTAIN(Android 2.13.1+ / iOSNestAdsSizeType.fluidContain), so exposing both was redundant and confusing. PickingfluidContainexplicitly never produced different behavior thanfluid. The wire format simplifies to'FLUID'/'FILL'/'FIXED'. TheisFluidContaingetter 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-packageat2.13.1-dev(unchanged). - Breaking — splash unified:
NestAdsWideSplashwidget / controller / options removed. The singleNestAdsSplashwidget 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 typedNestAdsPopupButtonOptionsreferenced asleftButton/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()(orinitializeIgnoringErrors()) before mounting any ad widget. NestAdsAdSizeis now backed by aNestAdsAdSizeTypeenum internally — wire format ('FLUID'/'FILL'/'FIXED') preserved. The DartfluidContainvalue has been removed: native factories already auto-routeFLUID→ SDKFLUID_CONTAINon platforms that support it, so exposing both was redundant.- Banner: typed
NestAdsBannerOptions(was free-form Map). AddsNestAdsBackgroundTypeenum. - Android: unified splash factory under a single
NestAdsSplashViewFactory(the wide factory file removed). - New:
NestAdsErrorReporterutility for reporting host-callback exceptions, plus aNestAdsEnvironmentconfig. Plugin gainscrypto,encrypt,httpruntime 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-SNAPSHOTfromhttps://nexus.wisebirds.ai/repository/snapshots/. - iOS (SPM):
nestads-sdk-ios-packageat2.13.1-devfromhttps://bitbucket.org/wisebirds/nestads-sdk-ios-package. - iOS (CocoaPods): the vendored
Frameworks/NestAdsSDK.xcframeworkis the DEV 2.13.1 build (sync viatool/sync-dev-xcframework.sh 2.13.1-devafter each native SDK bump). - Splash: split simple/wide cleanly —
NestAdsSplashis image-only on both platforms (no video callbacks/options); video belongs toNestAdsWideSplash. - Android: lifecycle-owner propagation via
findViewTreeLifecycleOwnerso 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-SNAPSHOTfromhttps://nexus.wisebirds.ai/repository/snapshots/. - iOS (SPM):
nestads-sdk-ios-packageat2.13.0-devfromhttps://bitbucket.org/wisebirds/nestads-sdk-ios-package. - iOS (CocoaPods): the vendored
Frameworks/NestAdsSDK.xcframeworkis the DEV 2.13.0 build (sync viatool/sync-dev-xcframework.sh 2.13.0-devafter each native SDK bump). - Banner: routes Dart
NestAdsAdSize.fluidto nativeFLUID_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 totool/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-SNAPSHOTfromhttps://nexus.wisebirds.ai/repository/snapshots/. - iOS (SPM):
nestads-sdk-ios-packageat2.13.0-devfromhttps://bitbucket.org/wisebirds/nestads-sdk-ios-package. - iOS (CocoaPods): the vendored
Frameworks/NestAdsSDK.xcframeworkis the DEV 2.13.0 build (sync viatool/sync-dev-xcframework.sh 2.13.0-devafter each native SDK bump).
0.1.1 #
- Bundle iOS
NestAdsSDK.xcframework2.11.0 (was stale in 0.1.0 — causedBackgroundBehavior/VideoPlayConditionunresolved 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) withloadAd()+ genericinvoke() - Typed options classes (
NestAds<Format>Options) for format-specific config - Bundled native SDKs: Android
com.nestads:nestads-sdk-android:2.11.0, iOS SPMwisebirds/nestads-ios-sdk:2.11.0