Flutter의 애플리케이션 아이콘 설정 방법

Flutter의 애플리케이션 아이콘 설정 방법

Flutter에서 애플리케이션 아이콘을 설정하는 것은 앱의 브랜드 아이덴티티를 확립하는 중요한 과정입니다. 기본 Flutter 프로젝트는 Flutter 로고를 아이콘으로 제공하지만, 실제로 배포할 때는 커스텀 아이콘을 적용해야 합니다.

이 글에서는 Flutter에서 애플리케이션 아이콘을 설정하는 방법을 설명하고, flutter_launcher_icons 패키지를 사용하여 Android 및 iOS 아이콘을 자동 생성하는 방법을 소개하겠습니다.

---

1. Flutter 애플리케이션 아이콘 설정 방법

Flutter에서는 두 가지 방법으로 아이콘을 설정할 수 있습니다.

• flutter_launcher_icons 패키지 사용: 자동으로 아이콘을 생성 및 적용
• 수동 설정: Android 및 iOS에서 직접 아이콘 파일을 변경

대부분의 Flutter 개발자는 flutter_launcher_icons 패키지를 사용하여 아이콘을 설정합니다. 이 방법은 간단하며, 한 번의 설정으로 Android와 iOS 모두 적용할 수 있습니다.

---

2. flutter_launcher_icons 패키지를 사용한 아이콘 설정

(1) 패키지 설치

Flutter 프로젝트에서 다음 명령어를 실행하여 flutter_launcher_icons 패키지를 추가합니다.

flutter pub add flutter_launcher_icons

또는 pubspec.yaml 파일의 dev_dependencies 섹션에 추가할 수도 있습니다.

dev_dependencies:
  flutter_launcher_icons: latest

(2) pubspec.yaml 설정

아이콘을 적용하려면 pubspec.yaml에 다음 설정을 추가합니다.

flutter_icons:
  android: true
  ios: true
  image_path: "assets/icon/app_icon.png"
  adaptive_icon_background: "#ffffff"
  adaptive_icon_foreground: "assets/icon/app_icon_foreground.png"

• image_path: 기본 아이콘 이미지 경로
• adaptive_icon_background: Android의 적응형 아이콘 배경
• adaptive_icon_foreground: Android 적응형 아이콘 전경

아이콘 이미지는 PNG 형식이어야 하며, assets/icon 폴더에 저장합니다.

(3) 아이콘 생성 및 적용

다음 명령어를 실행하여 아이콘을 생성합니다.

flutter pub run flutter_launcher_icons:main

이제 Android 및 iOS에 자동으로 애플리케이션 아이콘이 적용됩니다.

---

3. Android에서 아이콘 수동 설정

수동으로 아이콘을 설정하려면 android/app/src/main/res/ 폴더의 기존 아이콘을 교체해야 합니다.

• mipmap-hdpi: 72x72
• mipmap-mdpi: 48x48
• mipmap-xhdpi: 96x96
• mipmap-xxhdpi: 144x144
• mipmap-xxxhdpi: 192x192

아이콘을 직접 변경한 후, 프로젝트를 다시 빌드합니다.

flutter clean
flutter build apk

---

4. iOS에서 아이콘 수동 설정

iOS에서 아이콘을 수동으로 변경하려면 ios/Runner/Assets.xcassets/AppIcon.appiconset/ 폴더의 아이콘 파일을 교체해야 합니다.

• 아이콘 파일을 appicon.co와 같은 도구를 사용하여 생성
• 생성된 파일을 AppIcon.appiconset 폴더에 복사
• ios/Runner.xcodeproj를 Xcode에서 열고 아이콘이 올바르게 설정되었는지 확인

아이콘 변경 후 iOS 앱을 다시 빌드해야 합니다.

flutter clean
flutter build ios

---

5. 애플리케이션 아이콘 적용 확인

아이콘이 정상적으로 적용되었는지 확인하려면 앱을 실행하여 검토합니다.

flutter run

또한, Android 및 iOS 시뮬레이터에서 아이콘이 올바르게 표시되는지 확인할 수도 있습니다.

• Android: 에뮬레이터 또는 실제 기기에서 앱 실행
• iOS: Xcode 시뮬레이터 또는 실제 기기에서 앱 실행

아이콘이 정상적으로 적용되지 않았다면, flutter clean 명령어를 실행한 후 다시 빌드해 보세요.

---

결론

Flutter에서 애플리케이션 아이콘을 설정하는 방법은 다음과 같습니다.

• flutter_launcher_icons 패키지를 사용하여 아이콘을 자동 생성
• Android 및 iOS에서 수동 설정을 통해 아이콘을 직접 변경
• 아이콘 적용 후 빌드하여 최종적으로 확인

자동화된 방법을 사용하면 더 쉽게 아이콘을 변경할 수 있으며, 프로젝트 유지보수도 편리해집니다. 이제 애플리케이션 아이콘을 설정하여 앱의 브랜드 아이덴티티를 강화해 보세요!