async_wallpaper

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 (including wallpaper rotation APIs: start, stop, status, rotate now) and 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).

Preserves 3.1.0 rotation feature (interval, charging, time-of-day triggers) and merges structured 3.2.0 APIs. See CHANGELOG.md and doc/android-compatibility.md for migration.

Pub.dev: Run flutter pub publish from main at c411160 (dry-run 0 warnings, 188 KB).

• 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).

Full Changelog: 3.0.0...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.

What's Changed

• Fixed example not building by @guyluz11 in #44
• fix: add restoration state in example code by @codenameakshay in #47
• Without empty service by @guyluz11 in #46
• fix: add dynamic color to example app by @codenameakshay in #48
• v3.0.0: Major improvements + new features by @codenameakshay in #57

Full Changelog: 2.1.0...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.

What's Changed

• Crash on android 14 while setting live wallpaper fixed. by @naeem-shah in #36
• Added open wallpaper chooser function by @guyluz11 in #41

New Contributors

• @naeem-shah made their first contribution in #36
• @guyluz11 made their first contribution in #41

Full Changelog: 2.0.3...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

Full Changelog: 2.0.2...2.0.3

• Fix native external apply methods not working
• Update dependencies

What's Changed

• 2.0.2 | Fix: add timeout in goToHome + add toasts by @codenameakshay in #18

Full Changelog: 2.0.1...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

What's Changed

• 2.0.1 | Fix: Update to Flutter 3.3.3 + Android 13 by @codenameakshay in #13

Full Changelog: 2.0.0...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

• 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

• Add support for Android 12
• Fixed documentation

• Initial release
• Supports setting wallpaper from file/url
• Supports video live wallpapers (.mp4)

• Fixed documentation
• Add example gif, and screenshot