icons_launcher는 Flutter 애플리케이션에서 런처 아이콘을 업데이트하는 과정을 간소화하기 위해 설계된 명령줄 도구입니다. 안드로이드, iOS, macOS, Windows, 리눅스 등 여러 플랫폼에서 앱 아이콘의 생성과 배치를 자동화합니다. 아이콘 관리를 단순화함으로써 수작업 작업을 줄이고 다양한 기기 구성에서 일관성을 보장합니다. pub add를 통해 Flutter 프로젝트와 원활하게 통합되어, 복잡한 워크플로우 없이도 전문적인 앱 외관을 유지하고자 하는 개발자에게 적합합니다.
사용 사례
새로운 릴리스용 앱 아이콘 업데이트
다양한 플랫폼 간 아이콘 생성 자동화
장치 간 일관된 브랜딩 유지
디자인 변경 후 빠르게 아이콘 재생성
다중 플랫폼 앱 배포 지원
주요 기능
크로스플랫폼 아이콘 생성
명령줄 인터페이스 통합
자동 자산 폴더 업데이트
다양한 아이콘 크기 및 형식 지원
flutter pub add를 사용한 간단한 설정
적합한 대상
Flutter 개발자가 앱 브랜딩을 관리하고 있습니다
일관된 아이콘 배포가 필요한 팀
여러 운영 체제를 대상으로 하는 프로젝트
시간 절약을 위한 자동화 도구를 찾는 개발자
고려 사항
명령줄에 익숙해야 합니다
생성된 자산에 대한 수동 검증이 필요할 수 있습니다
정확한 입력 이미지 치수에 따라 달라집니다
실시간 아이콘 편집에 적합하지 않습니다
제한된 GUI 상호작용
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
🍃 Icons Launcher 🍃
A command-line tool that simplifies the task of updating your Flutter app's launcher icon. Full flexibility allows you to only update the launcher icon for specific platforms as needed.
Platform Support
Android
iOS
macOS
Web
Linux
Windows
✅
✅
✅
✅
✅
✅
Guide
1. Setup the config file
Add your Icons Launcher configuration to your pubspec.yaml or create a new config file called icons_launcher.yaml.
An example is shown below. More complex examples here.
Add config to pubspec.yaml or create a separate icons_launcher.yaml
Note
For IOS 18 icons dark and tinted also supported. See more on example config below.
2. Run the package
After setting up the configuration, all that is left to do is run the package:
flutter pub get
dart run icons_launcher:create
If you name your configuration file something other than icons_launcher.yaml or pubspec.yaml you will need to specify the name of the file when running the package.
flutter pub get
dart run icons_launcher:create --path <your config file name here>
Note
If you are not using the existing pubspec.yaml your config file must still be located in the same directory as it.
In the above configuration, the package is setup to replace the existing launcher icons in both the Android and iOS project.
Attributes
Shown below is the full list of attributes which you can specify within your Icons Launcher configuration.
Icons Launcher Option
Type
Default
Description
image_path
String
null
The image file path
platforms
Object
null
Use for specific platforms to generate icons
Platforms Option
Type
Default
Description
android
Object
null
Use for specific Android platform
ios
Object
null
Use for specific iOS platform
macos
Object
null
Use for specific macOS platform
windows
Object
null
Use for specific Windows platform
web
Object
null
Use for specific Web platform
linux
Object
null
Use for specific Linux platform
Android Option
Type
Default
Description
enable
Boolean
false
Use for enable Android platform
image_path
String
null
The image file path
notification_image
String
null
Image for the notification icon
adaptive_background_color
String
null
Color for fill out the background of the adaptive icon
adaptive_background_image
String
null
Image for fill out the background of the adaptive icon
adaptive_foreground_image
String
null
Image for the icon foreground of the adaptive icon
adaptive_round_image
String
null
Image for the round icon of the adaptive icon
adaptive_monochrome_image
String
null
Image for the monochrome version of the adaptive icon
iOS Option
Type
Default
Description
enable
Boolean
false
Use for enable iOS platform
image_path
String
null
The image file path
dark_path
String
null
The dark image file path
tinted_path
String
null
The tinted image file path
Web Option
Type
Default
Description
enable
Boolean
false
Use for enable Web platform
image_path
String
null
The image file path
maskable_image_path
String
null
The maskable image file path for PWA
favicon_path
String
null
The image file path
favicon_output_extension
String
.png
Extension for favicon .png or .ico
macOS Option
Type
Default
Description
enable
Boolean
false
Use for enable macOS platform
image_path
String
null
The image file path
Windows Option
Type
Default
Description
enable
Boolean
false
Use for enable Windows platform
image_path
String
null
The image file path
Linux Option
Type
Default
Description
enable
Boolean
false
Use for enable Linux platform with snapcraft
image_path
String
null
The image file path
Flavor support
Create a Icons Launcher configuration file for your flavor. The config file is called icons_launcher-<flavor>.yaml by replacing <flavor> by the name of your desired flavor.
Example: icons_launcher-dev.yaml and icons_launcher-prod.yaml
Run with flavor:
flutter pub get
# create for dev flavor
dart run icons_launcher:create --flavor dev
# create for prod flavor
dart run icons_launcher:create --flavor prod
Alternatively, you can run multiple flavors at the same time with the following command:
dart run icons_launcher:create --flavors dev,prod
The configuration file format is the same.
Example
icons_launcher:platforms:android:enable:trueimage_path:"assets/ic_logo_radius.png"notification_image:"assets/ic_foreground.png"# adaptive_background_color: "#ffffff"adaptive_background_image:"assets/ic_background.png"adaptive_foreground_image:"assets/ic_foreground.png"adaptive_round_image:"assets/ic_logo_round.png"adaptive_monochrome_image:"assets/ic_black_white.png"ios:enable:trueimage_path:"assets/ic_logo_rectangle_light.png"# For iOS 18+ (support dark and tinted)dark_path:"assets/ic_logo_rectangle_dark.png"tinted_path:"assets/ic_logo_rectangle_tinted.png"web:enable:falseimage_path:"assets/ic_logo_rectangle_light.png"maskable_image_path:"assets/ic_logo_radius.png"favicon_path:"assets/ic_logo_round.png"# favicon_output_extension: ".ico"macos:enable:falseimage_path:"assets/macos_icon.png"windows:enable:falseimage_path:"assets/ic_logo_radius.png"linux:enable:falseimage_path:"assets/ic_logo_radius.png"