masterfabric_app_icon 2.0.0 copy "masterfabric_app_icon: ^2.0.0" to clipboard
masterfabric_app_icon: ^2.0.0 copied to clipboard

A Flutter package for build-time app icon generation and runtime icon switching. Supports Android mipmap densities and iOS appiconset with flavor configurations. iOS 26 Liquid Glass optimized.

Changelog #

All notable changes to this project will be documented in this file.

2.0.0 - 2026-01-09 #

🎉 Major Release - iOS 26 Liquid Glass Support #

✨ New Features

  • iOS 26 Liquid Glass Optimization - High-quality icon generation optimized for iOS 26's Liquid Glass design system
  • Automatic Retry Logic - Handles transient errors with up to 5 retries and exponential backoff
  • High-Resolution Processing - Source images processed at 2048x2048 for optimal Liquid Glass rendering
  • New API Methods:
    • supportsAlternateIcons - Check if dynamic icons are supported
    • getAlternateIconName() - Get current icon name
    • setAlternateIconName() - Change icon with automatic retry
    • getAvailableIcons() - List all available icons

🔧 Improvements

  • iOS 26 Strict Name Resolution - Appiconset folder names now exactly match CFBundleIconName
  • Cubic Interpolation - Enhanced image quality for all generated icons
  • Level 9 PNG Encoding - Maximum quality without loss
  • App State Validation - Ensures app is active before icon changes
  • Clean Flag - --clean option to remove old appiconset folders

📱 Platform Support

  • iOS: Full iOS 26 Liquid Glass support with CFBundleIconName configuration
  • Android: Adaptive icons with mipmap densities (mdpi, hdpi, xhdpi, xxhdpi, xxxhdpi)

🔄 Breaking Changes

  • iOS appiconset naming changed from AppIcon-{prefix}-{flavor}.appiconset to {flavor}.appiconset
  • Requires CFBundleIconName instead of CFBundleIconFiles in Info.plist for iOS 26
  • Legacy API methods deprecated (still functional for backward compatibility)

📋 Current Icon Names

  • Main Package: dev, prod
  • Example App: AppIcon, icon1, icon2, icon3, designer, trabzonspor, ticimax

🐛 Bug Fixes

  • Fixed iOS 26 "Resource temporarily unavailable" errors
  • Fixed iOS 26 "Input/output error" errors
  • Fixed empty icon display when names don't match exactly

📚 Documentation

  • Added comprehensive iOS 26 troubleshooting guide
  • Added screenshots demonstrating app functionality
  • Updated configuration examples with current icon names

1.0.0 Initial Release #

Features #

  • Build-time app icon generation for Android and iOS
  • Runtime icon switching support
  • Flavor-based icon configuration
  • Android adaptive icon support
  • iOS appiconset generation
0
likes
150
points
70
downloads

Publisher

verified publishermasterfabric.co

Weekly Downloads

A Flutter package for build-time app icon generation and runtime icon switching. Supports Android mipmap densities and iOS appiconset with flavor configurations. iOS 26 Liquid Glass optimized.

Repository (GitHub)
View/report issues

Documentation

API reference

License

MIT (license)

Dependencies

args, flutter, image, path, yaml

More

Packages that depend on masterfabric_app_icon

Packages that implement masterfabric_app_icon