@spec adaptive_icon_xml() :: String.t()

Returns the XML body for mipmap-anydpi-v26/ic_launcher.xml.

Uses @mipmap/ic_launcher_foreground for the foreground and @color/ic_launcher_background for the background.

@spec adaptive_sizes() :: %{required(String.t()) => pos_integer()}

Returns the map of Android mipmap bucket names to pixel dimensions for adaptive-icon foreground layers (108×108 dp scaled per density).

@spec android_sizes() :: %{required(String.t()) => pos_integer()}

Returns the map of Android mipmap bucket names to pixel dimensions for legacy (single-layer) icons.

@spec background_color_xml(String.t()) :: String.t()

Returns the XML body for values/ic_launcher_background.xml defining the adaptive icon background colour.

Accepts hex strings with or without a leading # (case-insensitive). Raises ArgumentError for non-hex input.

@spec generate_adaptive(
  source_path :: String.t(),
  output_dir :: String.t(),
  keyword()
) :: :ok

Generates adaptive Android icons from a source image.

Writes:

• mipmap-anydpi-v26/ic_launcher.xml + ic_launcher_round.xml referencing @mipmap/ic_launcher_foreground and @color/ic_launcher_background
• mipmap-<bucket>/ic_launcher_foreground.png at the adaptive icon canvas size for each density bucket
• values/ic_launcher_background.xml defining the background color

Options

• :background_color — hex string like "#E8B53C". If absent, sampled from the source image at top-centre (10% from the top).

Legacy ic_launcher.png/ic_launcher_round.png are written separately by generate_from_source/2 for older Android versions.

@spec generate_from_source(source_path :: String.t(), output_dir :: String.t()) :: :ok

Resizes an existing image at source_path to all platform icon sizes, writing them into output_dir.

Returns :ok.

@spec generate_random(output_dir :: String.t()) :: :ok

Generates a random robot avatar and writes platform icons into output_dir.

Creates:

• output_dir/android/app/src/main/res/<bucket>/ic_launcher.png for each Android bucket
• output_dir/ios/Assets.xcassets/AppIcon.appiconset/icon_<px>.png for each iOS size
• output_dir/icon_source.png — the 1024×1024 master

Returns :ok on success.

@spec ios_sizes() :: [pos_integer()]

Returns the list of iOS icon pixel dimensions.

@spec use_mob_logo(output_dir :: String.t()) :: :ok

Copies the bundled Mob logo (pre-built PNGs) to all platform icon directories in output_dir. Used as the default placeholder icon by mix mob.install. No extra dependencies or system tools required.

Returns :ok.