NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev
AdropAds flutter plugin that shows ads using native platform views
Latest stable
1.17.0
Last release 13 days ago
09 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 54 of 56 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
60 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
Added AdropBannerView.preload(unitId:, adSize:) and AdropNativeAd.preload(unitId:, preferredAdChoicesPosition:). Call it before creating the ad view,
AdropBannerView.preload(unitId:, adSize:) and AdropNativeAd.preload(unitId:, preferredAdChoicesPosition:). Call it before creating the ad view, and the AdMob backfill ad is loaded in advance; the next load() of the same unit that falls back to backfill attaches it without waiting for AdMobactive: false), in both production and test mode. Otherwise it completes with PlatformException code ERROR_CODE_AD_PRELOAD_SKIPPED and makes no AdMob request, so apps that also run direct campaigns are not affected. Right after install, an app key change or setUID, it is skipped until the first remote config arrives. The public test units are always skippedawait the call inside try/catch, or for fire-and-forget append .catchError((_) {}). Every non-success outcome, including the skip, is thrown as a PlatformException whose code is the AdropErrorCode name; an un-awaited call without a handler reports each skip as an uncaught async errorERROR_CODE_AD_NO_FILL means the backfill module or the unit's AdMob mapping is missing; retry later, not in a loop. ERROR_CODE_INTERNAL means the request was dropped (e.g. the Android Activity was destroyed while loading)adSize (if adSize is omitted (320x50), set AdropBannerView.adSize = const Size(320, 50) on the consuming banner), a native ad with the same preferredAdChoicesPosition. Calling it again for a filled slot does not refresh it. Up to 5 different slots per format are kept, each for 30 minutesAdropErrorCode.preloadSkipped (an exhaustive switch over AdropErrorCode without default needs the new case)[1.17, 1.18), iOS: >= 1.17.0, < 1.18.0). Update the backfill SDK to 1.17 as wellYour coding agent can read these notes before it upgrades. Set up the MCP server →
Added AdropNativeProperties.extraAssets — every media slot defined on a native unit, keyed by slot ID (Map : id, asset, creative, cover, type, isVideo
AdropNativeProperties.extraAssets — every media slot defined on a native unit, keyed by slot ID (Map<String, AdropNativeAsset>: id, asset, creative, cover, type, isVideo). Only multi-media (slot) creatives carry entries; single-media creatives, legacy responses and backfill ads return an empty map (read the primary media from the existing fields). Data only — per-slot rendering and tracking are up to the publisherAdropNativeProperties.callToAction now returns the localized label for CTA keys (e.g. view_details → "View Details"), matching iOS. Empty values stay emptyshow() failed with ERROR_CODE_LANDSCAPE_UNSUPPORTED, which is no longer returned). While shown, the popup follows the app's rotation and re-lays out in place instead of locking the screen to portraitshow() for a popup unit that is already on screen, even from another instance, now fails with ERROR_CODE_AD_SHOWN[1.16, 1.17), iOS: >= 1.16.0, < 1.17.0). Update the backfill SDK to 1.16 as wellAdded privacy options to AdropConsentManager so users can change their consent later, e.g. from a "Privacy settings" entry in your settings screen
AdropConsentManager so users can change their consent later, e.g. from a "Privacy settings" entry in your settings screen
getPrivacyOptionsRequirementStatus() returns AdropPrivacyOptionsRequirementStatus (unknown / required / notRequired). When it is required, the entry point must be shownshowPrivacyOptionsForm(listener) shows the form and delivers the updated AdropConsentResult after the form closes. The change is applied to the SDK before the listener is calledrequestConsentInfoUpdate() on every app launch, even when consent was already obtained. The requirement status stays unknown until it completes in the current sessionreset() is for testing only and must not be called in production code. It no longer marks the user as consented; the previous choice is kept until consent is determined againrequestConsentInfoUpdate now always calls the listener, even if the activity is finishing when the consent form closes (e.g. on rotation). Previously the listener could be skipped and the Future never completed[1.15, 1.16), iOS: >= 1.15.0, < 1.16.0). Update the backfill SDK to 1.15 as wellAdded externalUid to AdropAdValue in onPaidEvent — the original value passed to Adrop.setUID(), or null if not set
externalUid to AdropAdValue in onPaidEvent — the original value passed to Adrop.setUID(), or null if not setonAdReceived again when AdMob refreshes the creativeERROR_CODE_AD_INACTIVE instead of ERROR_CODE_AD_NO_FILL[1.14, 1.15), iOS: >= 1.14.0, < 1.15.0)Added Swift Package Manager support on iOS. The plugin now ships a Swift package alongside the podspec, so it builds under Flutter's SwiftPM integrati
https://github.com/OpenRhapsody/adrop-ads-backfill-pod in Xcode for SwiftPM, or pod 'adrop-ads-backfill' for CocoaPods. Mixing the two links the native SDK twiceonPaidEvent, an impression-level ad revenue callback for AdMob backfill ads, on banner, native, interstitial and rewarded (including banner/native refresh). Adrop direct ads do not fire itAdropAdValue (network, adSourceName, valueMicros, currencyCode, precision). The value is the ad provider's own gross estimate, not a settlement figure[1.13, 1.14), iOS: >= 1.13.0, < 1.14.0)Added AdropBannerView.loads() and AdropNativeAd.loads() to load up to 5 ads with a single network request for feed/list screens. Returned banners are
AdropBannerView.loads() and AdropNativeAd.loads() to load up to 5 ads with a single network request for feed/list screens. Returned banners are ready-to-mount widgets and returned native ads are already loaded (isLoaded is true) — do NOT call load() on them. Batch ads are always direct ads (no backfill). Every returned instance owns a native WebView, so call dispose() on each one when done, including instances never mounted. On failure a PlatformException is thrown whose code is an AdropErrorCode name (e.g. ERROR_CODE_AD_NO_FILL)AdropBannerView.requestId getter and a requestId entry in banner listener callback metadata, so a listener shared across batch-loaded banners can tell which slot firedListView recycling an off-screen item) only detaches the native view, and remounting re-binds it. Both returned banners and AdropNativeAdView in a list should be keyed by requestId — platform views freeze their creation params, so an unkeyed widget reused at the same position after a new loads() would keep showing the old adUpdate native SDK dependency range (Android: [1.12, 1.13), iOS: >= 1.12.0, < 1.13.0)
[1.12, 1.13), iOS: >= 1.12.0, < 1.13.0)onAdImpression is now fired after the ad is actually presented on screen (previously fired right after show(), which could arrive before onAdShown), with a duplicate-impression guard and detection of presentation failuresAdView leaks on Android: the backfill view is now fully released when the banner is disposed, when a refresh swaps the creative, and when a direct ad replaces a backfill ad<video> element and its media session are now stopped when the banner is released, and the banner no longer resurrects (re-injecting the creative / re-counting impressions) after teardownAdded AdropNativeAd.dispose() to release native ad resources (the underlying WebView and, for backfill ads, the AdMob native ad). Call it when the ad
AdropNativeAd.dispose() to release native ad resources (the underlying WebView and, for backfill ads, the AdMob native ad). Call it when the ad is no longer displayed; a disposed instance cannot be reused. Not disposing leaks the native WebView and can lead to OOM in feed-style screensdispose() now destroys the underlying native banner, and stale event-handler references are releaseddispose() on interstitial/rewarded/popup ads now detaches the event handler, so a disposed ad no longer delivers callbacks and must not be reused — create a new instance insteadFixed missing impression tracking on backfill (AdMob) native ads by re-binding the platform view to the new native ad instance when a backfill ad is r
[1.11, 1.12), iOS: >= 1.11.0, < 1.12.0)Added Adrop.setMarketingConsent() to set the user's marketing consent for push notification ad targeting
Adrop.setMarketingConsent() to set the user's marketing consent for push notification ad targetingAdropAdChoicesPosition enum and preferredAdChoicesPosition parameter to AdropNativeAd to hint the AdChoices icon position on AdMob backfill native adscreativeType getter ('display' / 'video') to all ad types[1.11, 1.12), iOS: >= 1.11.0, < 1.12.0)Added video callbacks (onAdVideoStart, onAdVideoEnd) for Banner, Native, Popup ads
onAdVideoStart, onAdVideoEnd) for Banner, Native, Popup ads[1.10, 1.11), iOS: >= 1.10.0, < 1.11.0)Added Adrop.registerWebView() API for WebView registration
Adrop.registerWebView() API for WebView registrationUpdate native SDK dependency range (Android: [1.9, 1.10), iOS: >= 1.9.0, < 1.10.0)
[1.9, 1.10), iOS: >= 1.9.0, < 1.10.0)Deprecated AdropMetrics.logEvent() in favor of sendEvent()
AdropMetrics.sendEvent() method with typed Map<String, dynamic> params supportAdropMetrics.logEvent() in favor of sendEvent()[Android] Added close() method and back button support for AdropInterstitialAd
close() method and back button support for AdropInterstitialAdAdded BrowserTarget support to control how ad destination URLs open (external for system browser, internal for in-app browser)
BrowserTarget support to control how ad destination URLs open (external for system browser, internal for in-app browser)browserTarget property to all ad types (AdropBannerView, AdropInterstitialAd, AdropNativeAd, AdropPopupAd, AdropRewardedAd)Added User Messaging Platform (UMP) support for GDPR consent management on Android and iOS
Add gesture recognizers to UIKitView
Added backfill ad support: Automatically serves network ads when Adrop direct ads fail to load
Adrop.setTheme() method to control ad display theme (light, dark, auto)AdropPopupAdBreaking Change: Updated AdropAdEventCallback signature to provide comprehensive metadata instead of just creativeId
close() method to AdropPopupAd for programmatic ad dismissaltxId and campaignId for all ad types (AdropBannerView, AdropInterstitialAd, AdropNativeAd, AdropPopupAd, AdropRewardedAd)AdropAdEventCallback signature to provide comprehensive metadata instead of just creativeId
void Function(String unitId, String? creativeId)void Function(String unitId, Map<String, dynamic>? metadata)creativeId, txId, campaignId, requestId, destinationURL, creativeSizeWidth, creativeSizeHeightNothing published for this version
Nothing published for this version
Nothing published for this version
Improved gesture handling for AdropBannerView to prevent touch event conflicts with scrollable parent views
AdropBannerView to prevent touch event conflicts with scrollable parent viewsEnhanced layout rendering stability for AdropBannerView
AdropBannerViewuseCustomClick in AdropNativeAd to handle manual click eventsFix the issue where the onAdClicked of the AdropNativeAd is not being called.
onAdClicked of the AdropNativeAd is not being called.Android: Improved stability of AdropNativeAdView
AdropNativeAdViewAdded AdropBannerView, AdropNativeAd to support creative size
AdropBannerView, AdropNativeAd to support creative sizeUpdated AdropBannerView mapping key to ensure unique native view identification and prevent conflicts in multiple view instances.
AdropBannerView mapping key to ensure unique native view identification and prevent conflicts in multiple view instances.Close AdropPopupAd when the ad called dispose
AdropPopupAd when the ad called dispose- Support preview ads using adId
Support for multiple templates in AdropPopupAd
AdropPopupAdAdropPopupAdSupport creative in AdropNativeProperties for displaying CTA
creative in AdropNativeProperties for displaying CTAUpdated dependency configuration: implementation 'io.adrop:adrop-ads' -> api 'io.adrop:adrop-ads'
implementation 'io.adrop:adrop-ads' -> api 'io.adrop:adrop-ads'use Color.value in AdropPopupAd
Color.value in AdropPopupAdSupport Adrop.setUID for consistent web and app targeting
Adrop.setUID for consistent web and app targetingdestinationURL property to the AdropNativeProperties class.AdropMetrics.properties() for getting user properties
AdropMetrics.properties() for getting user properties[iOS] Support enable to use in-app browser
AdropNativeAdDeprecated AdropNavigatorObserver
String, int, double, boolAdropNavigatorObserverAdd error code: Account usage limit exceeded
- Update sdk
- Add AdropPopupAd - Support Splash Ad - Target countries
AdropPopupAd- Add AdropPopupAd - Support Splash Ad - Target countries
AdropPopupAdAdd AdropNavigatorObserver to measure the frequency of ad impressions
AdropNavigatorObserver to measure the frequency of ad impressionssetProperty for setting a user property
AdropMetricssetProperty for setting a user propertylogEvent for logging custom event[iOS] Privacy Policy Update (Effective from May 1, 2024)
Support adrop-ads version dynamically
- Support interstitial ad - Support rewarded ad
- AdropBannerView dispose
- flutter 3.3.0
Deprecated AdropBannerController, AdropBanner
- [iOS] initialize - check production level
- API Documentation
Nothing published for this version
Support kotlin 1.7.10 or higher
Nothing published for this version
- Update sdk
- Network update
- Update use ios sdk
- adrop_ads_flutter release
adrop_ads_flutter releaseOne column per quarter.