advanced_cache_network_image

Releases

1. ▸▾0.0.318 Mar 2026

   Added advanced user configurability in ImageLoader:

   🚀 API Enhancements

   • Added advanced user configurability in ImageLoader:
     • timeout
     • maxRetries
     • baseDelay
     • maxConcurrentDownloads
   • Made queue concurrency runtime-configurable through ViewportPriorityQueue.maxConcurrent
   • Extended loadBytes(...) to support:
     • useMemoryCache
     • useDiskCache
     • cacheDuration
   • Added ImageLoader.shared for reusable shared caching/dedup flows
   • Added cache control APIs:
     • ImageLoader.evict(...)
     • ImageLoader.clearMemoryCache()
   • Added widget-level customization in AdvancedCacheNetworkImage:
     • imageLoader (inject custom loader)
     • cancelToken (cancel in-flight request)
   • Wired widget cache flags/duration into byte-loading flow so cache options now apply during normal widget usage
   • Exported advanced classes from package root so users no longer need src/ imports:
     • ImageLoader
     • MemoryCache
     • DiskCache
     • NetworkFetcher
     • CancelToken
     • ViewportPriorityQueue

   📚 Documentation

   • Rewrote README.md with a complete package overview and accurate feature list
   • Updated installation instructions to advanced_cache_network_image: ^0.0.3
   • Added a clear "What You Can Update" section to document customizable widget, loader, and queue options
   • Added practical usage examples:
     • Basic image loading
     • Progress + error handling
     • Decode resizing (targetWidth, targetHeight)
     • Prefetch flow with ImageLoader.prefetch(...)
     • Advanced customization and manual cache control (evict, clearMemoryCache)
   • Added a clear widget parameter reference section
   • Added implementation notes to clarify current cache behavior and queue limits
   • Added a new troubleshooting section for:
     • Invalid URL failures
     • Stale cache behavior
     • Indeterminate progress when content-length is unavailable

   🧪 Example App

   • Rebuilt example/lib/main.dart as a live customization playground
   • Added interactive controls for:
     • memory/disk cache toggles
     • fade animation toggle
     • max retries
     • max concurrent downloads
     • decode target width
     • border radius
     • cache duration
   • Added demo actions to cancel in-flight download and clear demo cache

   ---