Flutter에서 앱 아이콘 변경하기

Flutter에서 앱 아이콘 변경하기

Flutter 앱을 배포할 때 기본 아이콘을 사용하지 않고, 프로젝트에 맞는 커스텀 앱 아이콘을 설정하는 것이 중요합니다. Flutter에서는 flutter_launcher_icons 패키지를 활용하여 간편하게 아이콘을 변경할 수 있습니다. 이번 글에서는 Flutter에서 앱 아이콘을 설정하는 방법과 플랫폼별 주의사항을 자세히 알아보겠습니다.

---

1. flutter_launcher_icons 패키지 설치

Flutter에서 앱 아이콘을 쉽게 설정하려면 flutter_launcher_icons 패키지를 사용합니다.

설치 명령어

flutter pub add flutter_launcher_icons

또는 pubspec.yaml에 직접 추가합니다.

dev_dependencies:
  flutter_launcher_icons: ^0.13.1

flutter_icons:
  android: true
  ios: true
  image_path: "assets/app_icon.png"
  adaptive_icon_background: "#ffffff" # (Android 전용)
  adaptive_icon_foreground: "assets/app_icon_foreground.png" # (Android 전용)

---

2. 아이콘 생성 명령 실행

설정 후 다음 명령어를 실행하면 아이콘이 자동으로 생성됩니다.

flutter pub run flutter_launcher_icons:main

이 명령어를 실행하면 android/app/src/main/res/mipmap-*/ic_launcher.png 및 ios/Runner/Assets.xcassets/AppIcon.appiconset/ 디렉터리에 앱 아이콘이 적용됩니다.

---

3. 플랫폼별 세부 설정

3.1 Android 아이콘 설정

• 안드로이드는 기본 아이콘과 어댑티브 아이콘을 지원합니다.
• adaptive_icon_background, adaptive_icon_foreground 설정을 추가하면 어댑티브 아이콘을 사용할 수 있습니다.

수동 설정 방법 (선택 사항)

Android 프로젝트에서 android/app/src/main/res/mipmap-*/ic_launcher.png 파일을 직접 교체할 수도 있습니다.

3.2 iOS 아이콘 설정

• iOS는 ios/Runner/Assets.xcassets/AppIcon.appiconset/ 폴더 내 아이콘 파일을 교체하여 적용할 수 있습니다.
• flutter_launcher_icons 패키지를 실행하면 자동으로 생성됩니다.
• Xcode에서 아이콘을 확인하려면 Runner.xcworkspace를 열어 Assets에서 확인합니다.

iOS에서 아이콘이 적용되지 않을 경우

flutter clean
flutter pub get

위 명령어 실행 후 다시 빌드합니다.

---

4. 아이콘 적용 확인

아이콘 적용 후 앱을 실행하여 아이콘이 정상적으로 변경되었는지 확인합니다.

flutter run

또는 iOS의 경우 Xcode에서 직접 아이콘을 확인할 수도 있습니다.

---

5. 주의할 점

• 아이콘 크기: 1024x1024 해상도의 아이콘을 사용하면 모든 플랫폼에서 깨끗하게 표시됩니다.
• 아이콘 배경: 배경이 투명한 PNG 파일을 사용하면 안드로이드에서 어댑티브 아이콘이 적용되지 않을 수 있습니다.
• iOS 아이콘 규칙: iOS에서는 마스크 처리가 자동으로 적용되므로 사각형 아이콘을 업로드해야 합니다.

---

6. 결론

Flutter에서 앱 아이콘을 변경하는 것은 flutter_launcher_icons 패키지를 사용하면 매우 간단합니다. 위의 가이드를 따라 설정하면 원하는 커스텀 아이콘을 적용할 수 있으며, 배포 전에 앱의 아이덴티티를 확실히 표현할 수 있습니다. 아이콘 설정 후 flutter clean과 flutter pub get을 실행하는 것도 잊지 마세요!