masterfabric_app_icon 2.0.0
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 supportedgetAlternateIconName()- Get current icon namesetAlternateIconName()- Change icon with automatic retrygetAvailableIcons()- 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 -
--cleanoption 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}.appiconsetto{flavor}.appiconset - Requires
CFBundleIconNameinstead ofCFBundleIconFilesin 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