Skip to content
pubscout

flutter_dynamic_launcher_icon

1.0.0, released 3 months ago by fluttership.io

Dynamically change the app launcher icon on Android and iOS at runtime.

WASM-ready
$ flutter pub add flutter_dynamic_launcher_icon
Source repository

What it does

A Flutter plugin that lets applications switch their launcher icon dynamically on both Android and iOS. It provides an API to change, reset, and check the currently active app icon.

AI-written summary of version 1.0.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You want to let users customize their app launcher icon from within the app settings.
  • Your app has seasonal, achievement-based, or user-selectable icon themes.

Skip it when

  • You only need to generate static icons at build-time rather than changing them dynamically at runtime.
  • You require hidden or automatic icon changes on iOS using unsupported private APIs.

Strengths

  • Supports both Android and iOS out of the box.
  • Provides clear handling of platform-specific behaviors like Android's deferred background icon application.

Weaknesses

  • Requires manual native configuration including Android activity-aliases and iOS asset catalogs.
  • iOS icon changes trigger a native system confirmation alert.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
1

Requires adding alternate icons to Android mipmap folders and updating AndroidManifest.xml with activity-aliases, as well as setting up alternate app icon sets in Xcode for iOS.

await FlutterDynamicLauncherIcon.changeIcon('AppIconDart');
await FlutterDynamicLauncherIcon.changeIcon(null);

Alternatives

Packages that do the same job and could replace flutter_dynamic_launcher_icon.

  • flutter_launcher_icons

    Pick flutter_launcher_icons if you only need to configure static launcher icons at build-time rather than changing them dynamically at runtime.

Works with

Packages commonly used together with flutter_dynamic_launcher_icon: ones it builds on, ones built on it, and its own family.