native_animated_image 0.2.2

Native (Rust + system ImageIO/ImageDecoder) decoder for animated GIF / APNG / WebP / AVIF. Bypasses Flutter Skia multi-frame codec.

Changelog

0.2.2 - 2026-06-05

Bug fix: NativeAnimatedImageProvider now falls back to Flutter's built-in codec for static images.

Before 0.2.2, calling NativeAnimatedImageProvider with a static WebP / PNG / JPEG image would fail with kErrUnsupported (the Rust pipeline only handles GIF / APNG / animated WebP / AVIF). Callers had to pre-filter URLs to route static images elsewhere — easy to get wrong (e.g. routing all .webp URLs to this provider would break for static webp, which is the majority case).

Now the provider transparently falls back to ui.instantiateImageCodecFromBuffer when Rust returns kErrUnsupported, so the contract is: any image the platform can display, this provider can display. Static formats avoid the #85831 Skia disposal bug by construction (the bug only fires on multi-frame disposal paths).

0.2.1 - 2026-06-05

Pure-Rust AVIF decoder added as fallback for the platform-native path.

• New crates/native_animated_image_codec/src/avif_decoder.rs powered by zenavif (rav1d + zenavif-parse) — pure Rust, no C dependencies, supports static + animated + alpha.
• NativeAvifPlatform.decode now transparently falls back to the Rust decoder when the platform's system decoder fails or isn't available. Notably covers:
  • Android animated AVIF (system ImageDecoder can decode animated AVIF but won't let us pull individual frames out of an AnimatedImageDrawable — we go through Rust instead).
  • iOS < 16.4 / macOS < 13.4 (no system AVIF decoder).
  • Windows / Linux (no native bridge).
• Performance: Rust path is ~5% slower than libavif/dav1d C path, so Apple/Google's optimized ImageIO/ImageDecoder is still preferred when available. Rust catches the rest.

0.2.0 - 2026-06-05

Platform-native AVIF decoder — new top-level addition.

• Added NativeAvifPlatform API: routes AVIF bytes through the OS's optimized decoder via a method channel (iOS/macOS CGImageSourceCreateWithData on system ImageIO, Android ImageDecoder on API 31+).
• Targets parity with Safari iOS 16.4+ / macOS 13.4+ AVIF decoding, which uses the same Apple-internal ImageIO codepath — community-reported 2-5x faster than the bundled third-party libavif/dav1d that flutter_avif ships.
• Static AVIF works on all listed platforms. Animated AVIF works on iOS 16.4+ / macOS 13.4+; Android animated AVIF currently throws so callers can fall back to their own backend.
• Suggested usage:

  if (await NativeAvifPlatform.canUse()) {
    final decoded = await NativeAvifPlatform.decode(bytes);
    // decoded.frames[0].rgba is RGBA8888 ready for ui.decodeImageFromPixels
  }
  

GIF/APNG/WebP path is unchanged from 0.1.x.

0.1.2 - 2026-06-05

• iOS ship Rust as a dynamic framework (dylib bundled in .framework), not a static .a. Static-lib FFI symbols get dead-stripped (no compile-time caller) and Xcode 16 rejects every -force_load workaround as an unresolved build input. Dylib is loaded by dyld at app startup → all native_animated_image_* symbols are immediately available to DynamicLibrary.process().
• tool/build_native.dart ios now builds cdylib for both ios-arm64 and ios-arm64-simulator, wraps each in a .framework bundle with correct install_name + Info.plist (bundle ID with dashes only, no underscores), and packs them into an xcframework.

0.1.1 - 2026-06-05

• iOS podspec: ship native_animated_image_codec.xcframework (Apple recommended) instead of separate device / simulator .a files behind SDK-conditional LIBRARY_SEARCH_PATHS. Old form broke when consumers installed via pub.dev (path was monorepo-relative). Linker error "Library 'native_animated_image_codec' not found" is fixed.
• No API / behavior changes to main package; bumped to pull the fixed iOS impl.

0.1.0 - 2026-06-04

Initial release.

• GIF decoder (full disposal & transparency handling)
• APNG decoder (acTL / fcTL / fdAT, all blend & dispose ops)
• Animated WebP decoder (via image-webp)
• NativeAnimatedImageProvider — drop-in Flutter ImageProvider
• Isolate-based decode, Timer-driven frame scheduling, hasListeners auto-pause
• Platforms: macOS, iOS, Android, Windows, Linux