PackageTrack
Sign in Get early access

aqua_ad_widget

Flutter widget for Revive Adserver integration with image/video ads, auto-refresh, click tracking, and carousel support.

5.1.0 appfactorysrl/aqua-ad-widget

What this package is like to depend on

Last release 6 months ago

28 Jan 2026

Release timing varies

gaps range from 8 days to 2 months

Nearly every release is documented

notes for 31 of 31 stable releases

Nothing withdrawn

no release was ever pulled

11 months old

31 releases · first in 2025

31 releases in the last 12 months

see the full history below

Release timeline

31 releases · Sep 2025 to Jan 2026
2026
Release Pre-release

Releases

latest 31
  1. 5.1.0 28 Jan 2026
    Release notes
    • MAJOR: Fix Chrome HLS video playback issues in carousels with HLS.js integration
    • Add HLS.js support for reliable HLS video streaming on web browsers
    • Fix CHUNK_DEMUXER_ERROR_APPEND_FAILED error when switching between video slides
    • Improve video lifecycle management with proper mount/unmount handling
    • Add comprehensive debug logging for video playback troubleshooting
    • Reduce unnecessary widget rebuilds in carousel mode
    • Add null-safety checks for all video event listeners
    • Automatic fallback to native video player when HLS.js is not available
    • Web-only changes - no impact on Android, iOS, or desktop platforms
    • Require HLS.js script in web/index.html for optimal video performance
    Open source →
  2. 5.0.3 19 Jan 2026
    Release notes

    Fix Safari mobile iOS video fullscreen issue in carousels

    Open source →
    Release notes
    • Fix Safari mobile iOS video fullscreen issue in carousels
    • Add playsinline and webkit-playsinline attributes to prevent automatic fullscreen
    • Add autoplay attribute for immediate video loading on slide change
    • Improve video visibility and playback on iOS Safari
    Open source →
  3. 5.0.2 11 Jan 2026
    Release notes
    • Update version to 5.0.2
    • Add changelog entry for SEO optimization
    Open source →
    Release notes
    • Optimize package description for better SEO and search engine visibility
    • Shorten description to 118 characters (within recommended 60-180 range)
    • Improve discoverability on pub.dev and search engines
    Open source →
  4. 5.0.1 11 Jan 2026
    Release notes
    • Update version to 5.0.1
    • Add changelog entry for impression tracking fix
    Open source →
    Release notes
    • Fix impression tracking beacon URL decoding issue
    • Resolve HTML entity decoding in beacon URLs (& -> &)
    • Ensure proper ad impression tracking for zone analytics
    • Fix beacon loading failures that affected impression counting
    Open source →
  5. 5.0.0 10 Jan 2026
    Release notes
    • Fix all static analysis issues
    • Add comprehensive test coverage (12 tests)
    • Improve documentation and examples
    • Add proper error handling with ignore comments
    • Optimize pubspec.yaml with better description and topics
    • Remove obsolete files
    • Perfect pub.dev compliance
    Open source →
    Release notes
    • MAJOR: Fix double video player instantiation in carousels
    • Add lazy video loading with isVisible parameter to prevent multiple simultaneous players
    • Add fallback ad detection by comparing zone IDs in click URLs
    • Add noFallbackWhenCarousel setting to filter fallback ads from carousels
    • Add global configuration AquaConfig.setDefaultNoFallbackWhenCarousel()
    • Add per-widget override via AquaSettings.noFallbackWhenCarousel
    • Improve debug logging - all video logs now respect AquaConfig.setDebugMode()
    • Add comprehensive debug logs for fallback detection and filtering
    • Only visible videos in carousels are initialized and play, preventing resource waste
    • Fallback ads are automatically filtered when non-fallback ads are available
    • Single ads are never filtered (fallback filtering only applies to carousels)
    • Update documentation with debug mode and fallback filtering sections
    Open source →
  6. 4.3.0 09 Jan 2026
    Release notes
    • Add automatic beacon tracking pixel detection and loading for impression tracking
    • Parse HTML content to detect tracking beacons (1x1 images, lg.php URLs, beacon keywords)
    • Load beacons using invisible overlay images to avoid CORS issues
    • Full compatibility with Revive AdServer and Aqua Platform impression tracking
    • Improve ad impression accuracy and analytics data collection
    Open source →
  7. 4.2.1 22 Dec 2025
    Release notes

    Release v4.2.1 - Minor improvements

    Open source →
    Release notes
    • Minor code improvements and optimizations
    Open source →
  8. 4.2.0 18 Dec 2025
    Release notes

    Release 4.2.0: Persistent mute state and fixed widget dimensions

    Open source →
    Release notes
    • Add persistent mute/unmute state across video ads within the same widget
    • Fix widget height collapsing during ad transitions in responsive layouts
    • Capture and maintain calculated dimensions using LayoutBuilder
    • Improve stability for widgets without fixed width
    • Enhance user experience with consistent audio state across video transitions
    Open source →
  9. 4.1.0 18 Dec 2025
    Release notes

    Release 4.1.0: Smart preloading and video duration-based transitions

    Open source →
    Release notes
    • Improve ad preloading to start immediately (1 second) instead of 5 seconds before refresh
    • Fix video widget recreation issue causing second videos to freeze
    • Add unique keys to video widgets to force proper recreation on URL change
    • Maintain widget dimensions during ad transitions to prevent layout shifts
    • Optimize preloading for short video ads
    • Improve overall video playback stability and transitions
    Open source →
  10. 4.0.0 18 Dec 2025
    Release notes
    • MAJOR: Add smooth ad transitions with preloading system
    • Add optional progress bar with showProgressBar and progressBarColor parameters
    • Implement background ad loading 5 seconds before transition
    • Eliminate empty loading states during ad refresh
    • Add video progress synchronization for progress bar
    • Progress bar respects widget borderRadius and positioning
    • Fallback to traditional loading if preload fails
    • Skip preloading for refresh intervals < 5 seconds
    • Improve user experience with seamless ad transitions
    Open source →
  11. 3.4.4 16 Dec 2025
    Release notes

    v3.4.4: Add pointer cursor on clickable ads for web

    Open source →
    Release notes
    • Add pointer cursor (hand) on web when banner has click URL
    • Improve user experience with visual feedback for clickable ads
    • Apply cursor change to both image and video ads
    Open source →
  12. 3.4.3 15 Dec 2025
    Release notes
    • Fix critical timer bug causing 0-second refresh intervals
    • Improve refresh timer validation to prevent invalid intervals
    • Fix type casting issue in adRefreshSeconds parameter handling
    • Add protection against negative or zero timer values
    • Remove debug logging for production release
    Open source →
    Release notes
    • Fix critical timer bug causing 0-second refresh intervals
    • Improve refresh timer validation to prevent invalid intervals
    • Fix type casting issue in adRefreshSeconds parameter handling
    • Add protection against negative or zero timer values
    • Remove debug logging for production release
    Open source →
  13. 3.4.2 12 Dec 2025
    Release notes
    • Fix infinite loop caused by image loading errors
    • Add permanent error state to prevent continuous reload attempts
    • Improve error handling with SchedulerBinding for safe setState calls
    • Add comprehensive protection against timer restarts on errors
    • Enhance stability when ads fail to load or display
    Open source →
    Release notes
    • Fix infinite loop caused by image loading errors
    • Add permanent error state to prevent continuous reload attempts
    • Improve error handling with SchedulerBinding for safe setState calls
    • Add comprehensive protection against timer restarts on errors
    • Remove debug print statements for production release
    • Enhance stability when ads fail to load or display
    Open source →
  14. 3.4.1 12 Dec 2025
    Release notes
    • Fix infinite loop issue caused by didChangeDependencies cycles
    • Fix context access error in initState() for locale detection
    • Add protection against multiple simultaneous loadAd calls
    • Improve locale caching to prevent unnecessary reinitializations
    • Add early returns to prevent timer starts on errors
    • Enhance error handling and debugging capabilities
    • Add debug page for troubleshooting widget behavior
    Open source →
  15. 3.4.0 04 Dec 2025
    Release notes
    • Add multi-language support (English, Italian, Spanish, French, German)
    • Add automatic locale detection from device/browser
    • Add hideIfEmpty configuration to hide widget when no ads available
    • Add locale parameter to AquaSettings for per-widget language override
    • Add setDefaultLocale() and setDefaultHideIfEmpty() to AquaConfig
    • Improve adCount: 'auto' to adapt to actual number of ads received
    • Optimize auto mode to request only detected ad count after first load
    • Add white background to loading and error states
    • Export AquaLocalizations class for public use
    • Fix single ad behavior in auto mode (no carousel, proper refresh)
    Open source →
  16. 3.3.2 03 Dec 2025
    Release notes
    • Maintenance release
    Open source →
  17. 3.3.1 03 Dec 2025
    Release notes
    • Fix borderRadius parameter support for mobile platforms (Android/iOS)
    • Add missing borderRadius parameter to video_ad_widget_mobile.dart
    • Ensure feature parity between web and mobile video implementations
    Open source →
  18. 3.3.0 03 Dec 2025
    Release notes
    • Add borderRadius parameter for rounded corners on ads
    • Apply border radius directly to video and image elements for better Safari compatibility
    • Update dependencies: http ^1.6.0, video_player ^2.10.1, flutter_lints ^6.0.0
    • Fix library name deprecation warning
    • Improve example app with dark gradient background and glass effect AppBar
    Open source →
  19. 3.2.0 26 Sep 2025
    Release notes
    • Add AquaSettings class for per-widget configuration
    • Rename setImageRefreshSeconds to setDefaultAdRefreshSeconds with deprecation
    • Rename setCarouselAutoAdvance to setDefaultCarouselAutoAdvance with deprecation
    • Add ability to disable auto-refresh by setting adRefreshSeconds to false
    • Move baseUrl and location parameters to AquaSettings with deprecation
    • Improve API consistency with settings-based configuration
    • Maintain backward compatibility with deprecated parameters
    Open source →
  20. 3.1.0 23 Sep 2025
    Release notes
    • Add configurable carousel auto-advance functionality
    • Fix web video widget inspector errors with unique keys
    • Add carousel timer management for automatic slide progression
    • Improve video handling in carousel mode
    • Perfect 160/160 pub.dev score with 100% documentation
    Open source →
  21. 3.0.0 23 Sep 2025
    Release notes
    • BREAKING: WASM compatibility - conditional video widget implementation
    • Add support for all Flutter platforms: macOS, Linux, Windows
    • Web implementation uses HTML video elements (WASM compatible)
    • Mobile/Desktop implementation uses video_player package
    • Conditional exports prevent dart:io dependency on web platforms
    • Full cross-platform support maintained
    Open source →
  22. 2.2.0 23 Sep 2025
    Release notes
    • BREAKING: Improve pub.dev score with comprehensive improvements
    • Add complete dartdoc documentation for all public API elements
    • Replace dart:html with dart:js_interop for WASM compatibility
    • Fix all static analysis issues and formatting
    • Resolve test compatibility issues
    • Achieve full pub.dev scoring requirements
    Open source →
  23. 2.1.1 22 Sep 2025
    Release notes
    • Add documentation for finding server URL in Revive AdServer and Aqua Platform control panels
    • Clarify default server URL configuration in README
    • Improve setup instructions with step-by-step guide for URL discovery
    Open source →
  24. 2.1.0 18 Sep 2025
    Release notes
    • MAJOR: Replace dart:html with video_player for unified cross-platform video support
    • Fix iOS build errors by removing web-only dependencies
    • Unified video implementation works on Android, iOS, and Web
    • Video ads now start muted with working mute/unmute toggle
    • Video scaling improved with proper cover behavior and clipping
    • Prevent premature video reload during initialization
    • Simplified codebase with single video widget implementation
    Open source →
  25. 2.0.1 18 Sep 2025
    Release notes
    • Fix dart analyze issues
    • Resolve undefined_identifier error
    • Make _pageController final
    • Replace deprecated withOpacity with withValues
    Open source →
  26. 2.0.0 18 Sep 2025
    Release notes
    • BREAKING CHANGES: Major feature release with new parameters
    • Add ratio parameter for aspect ratio control (default: 16/9)
    • Add autoGrow parameter to use actual ad dimensions for ratio
    • Add adCount parameter for carousel functionality
    • Support adCount: 'auto' mode to load up to 5 ads automatically
    • Implement carousel with PageView and dot navigation
    • Smart widget sizing: fixed width or full container width with ratio
    • Filter invalid ads (width/height = 0) automatically
    • Disable auto-refresh when carousel is active
    • Preserve video auto-refresh on end behavior
    • Update example app with comprehensive demonstrations
    • Update documentation with all new parameters and usage examples
    Open source →
  27. 1.1.2 17 Sep 2025
    Release notes
    • Remove prefix parameter to simplify API
    • Fix server response parsing (handle array format)
    • Widget disappears completely when no ads available
    • Improve error handling and user experience
    Open source →
  28. 1.1.1 17 Sep 2025
    Release notes
    • Fix mobile click handling with platform-specific URL launcher
    • Add clean architecture for cross-platform URL handling
    • Resolve compilation errors on all platforms
    • Improve code organization with separate utility files
    Open source →
  29. 1.1.0 17 Sep 2025
    Release notes
    • Add Android and iOS platform support
    • Refactor to single unified widget with conditional imports
    • Add url_launcher dependency for mobile link handling
    • Improve code maintainability with unified codebase
    Open source →
  30. 1.0.2 17 Sep 2025
    Release notes
    • Update README with English documentation
    • Add Aqua Platform compatibility information
    • Document supported banner types (Local, External, AdserverPlugins.com In-Banner Video)
    Open source →
  31. 1.0.1 17 Sep 2025
    Release notes
    • Change zoneId parameter from String to int
    • Add global configuration for base URL (AquaConfig.setDefaultBaseUrl)
    • Improve API consistency
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive