adaptive_app_icon

Releases

1. ▸▾0.1.023 Jul 2026

   Declare one source image per icon; the codegen produces every platform asset and bundles it. No hand-cut densities, and no Xcode *Copy Bundle Resource

   Declare one source image per icon; the codegen produces every platform asset and bundles it. No hand-cut densities, and no Xcode Copy Bundle Resources step.

   Breaking

   • The ios_asset: key is gone — iOS app-icon sets are now named after the icon itself, so the name is derived. Codegen errors with a migration hint if the key is still present. android_asset: is now optional too, defaulting to ic_launcher for the primary icon and ic_launcher_<name> for alternates.
   • Icon name must be lower_snake_case: it becomes an iOS app-icon set name and an Android component name.
   • iOS alternate icons move from loose PNGs in ios/Runner/ to app-icon sets in Assets.xcassets. Delete the old AppIcon-*@2x.png / @3x.png files in Xcode (codegen warns while any remain); the CFBundleIcons block that referenced them is stripped from ios/Runner/Info.plist automatically. See the migration steps in the README.

   Added

   • image: renders the Android density PNGs (mdpi→xxxhdpi, alpha preserved) and the iOS app-icon sets (flattened, since iOS renders an alpha channel as a black square) from a single square master.
   • Config can live in pubspec.yaml under adaptive_app_icon:; a standalone adaptive_app_icon.yaml still works as a fallback.
   • Xcode asset-catalog build settings are set on every build configuration, so alternates are bundled without editing Copy Bundle Resources — the silent blank-icon failure that layout allowed is gone.
   • background: (per icon or top level) sets what iOS icons are flattened onto.
   • preview: defaults to image:, so the gallery needs no extra file.
   • --no-images wires up existing assets without re-rendering.
   • Codegen warns when a preview isn't declared under flutter: assets:, which otherwise shows a placeholder at runtime with no error.

   Fixed

   • The manifest emitted android:icon="@mipmap/…" even when validation had accepted a drawable-*/ resource, producing a reference that failed to resolve. The container is now detected and the matching prefix emitted.