async_wallpaper 3.2.0 copy "async_wallpaper: ^3.2.0" to clipboard
async_wallpaper: ^3.2.0 copied to clipboard

Set wallpapers on Android asynchronously. Also supports video live wallpapers.

3.2.0 #

  • Add structured Android static-wallpaper requests with URL, file-path, content-URI, and byte sources.
  • Add explicit image scale modes and direct/system-cropper/system-picker/automatic apply strategies.
  • Add truthful WallpaperOperationResult and per-target home/lock outcomes instead of treating a UI launch as an applied wallpaper.
  • Add getCapabilities() for static, live, OpenGL, target, picker, foreground, OEM, and GLES availability checks.
  • Add typed video preparation and live-preview APIs; preparation and Android user confirmation are now distinct statuses.
  • Add bounded OpenGL ES 2.0 live-wallpaper support with shader validation and typed OpenGL requests.
  • Serialize native wallpaper operations, preserve partial both-target results, and make direct static application safe for headless/background execution.
  • Retain goToHome request fields for source compatibility while removing package-side automatic navigation.
  • Make the live-wallpaper manifest feature optional, remove broad media/storage permissions, and expose overrideable live-wallpaper branding resources.
  • Keep 3.1 APIs source-compatible; mark the legacy live-wallpaper shortcut deprecated in favor of structured results.
  • Refresh the example, migration/API docs, Android compatibility notes, and the 3.2 issue-resolution ledger.
  • OpenGL/video live-wallpaper flows are syntax- and state-machine-tested; GPU compile/link and OEM preview target selection still require physical device verification (see doc/android-compatibility.md).

3.1.0 #

  • Add Android wallpaper rotation APIs: start, stop, status, and rotate now.
  • Add mixed rotation playlist support for URL and file sources with local caching.
  • Add rotation order modes: sequential and shuffle.
  • Add rotation triggers for interval, charging connected, and time-of-day windows.
  • Enforce minimum rotation interval of 15 minutes.
  • Add active hours configuration for time-of-day trigger.
  • Add basic iOS support with download-only capability (save wallpaper to Photos).
  • Add cross-platform downloadWallpaper(...) API (iOS + Android).
  • Add iOS plugin implementation using Swift + Pigeon host bindings.
  • Existing apply/live/chooser operations now return typed unsupported on iOS.
  • Add iOS example runner and Photos permission usage description for demo app.
  • Update example app and docs with rotation controls.

3.0.0 #

  • Upgrade baseline to Flutter 3.41.4 via FVM.
  • Migrate Android host implementation from Java to Kotlin.
  • Upgrade Android build stack to AGP 8.11.1, Gradle 8.14, Kotlin plugin 2.2.20, Java 17.
  • Raise Android minimum SDK to 24.
  • Regenerate platform channel bindings using Pigeon Kotlin host output.
  • Breaking API redesign:
    • Replace integer location constants with enums.
    • Replace bool-focused APIs with typed request/result models.
    • Remove package-owned toast behavior and fluttertoast dependency.
  • Refresh example app to use the v3 typed API.

2.1.0 #

  • Fix Android 14 crash in apply methods
  • Add method to open native wallpaper chooser
  • Update to Flutter v3.22.1
  • Update dependencies

2.0.3 #

  • Fix native external apply methods not working
  • Update dependencies

2.0.2 #

  • Add fluttertoast package to show success/failure toasts
  • Add timeout of 2 seconds in goToHome method to prevent it looking like a crash

2.0.1 #

  • Add support for Flutter 3.3.3
  • Update dependencies

2.0.0 #

  • Add support for Android 13
  • Add a new bool parameter goToHome to all methods
  • Breaking change - All methods now return a bool instead of String, to make error handling easier
  • Breaking change - All methods now accept named parameters instead of positional parameters
  • Fixed documentation

1.0.1 #

  • Add support for Android 12
  • Fixed documentation

1.0.0+1 #

  • Fixed documentation
  • Add example gif, and screenshot

1.0.0 #

  • Initial release
  • Supports setting wallpaper from file/url
  • Supports video live wallpapers (.mp4)
90
likes
160
points
955
downloads

Documentation

API reference

Publisher

verified publisherhashstudios.dev

Weekly Downloads

Set wallpapers on Android asynchronously. Also supports video live wallpapers.

Homepage
Repository (GitHub)
View/report issues
Contributing

License

MIT (license)

Dependencies

flutter

More

Packages that depend on async_wallpaper

Packages that implement async_wallpaper