nestads_sdk_flutter_plugin 0.2.0-dev.2
nestads_sdk_flutter_plugin: ^0.2.0-dev.2 copied to clipboard
Official NestAds SDK for Flutter. Banner, popup, and splash ads with native Android and iOS integration.
Changelog #
Unreleased #
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