Skip to main content

nestads_sdk_flutter_plugin 0.2.0-dev.2 copy "nestads_sdk_flutter_plugin: ^0.2.0-dev.2" to clipboard
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.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
0
points
964
downloads

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

unknown (license)

Dependencies

crypto, encrypt, flutter, http, visibility_detector

More

Packages that depend on nestads_sdk_flutter_plugin

Packages that implement nestads_sdk_flutter_plugin