Flutter Launcher Icons - 온더테크

Contents

플러터 런처 아이콘 개요 (Overview of Flutter Launcher Icons)

flutter_launcher_icons는 플러터 앱에서 런처 아이콘을 쉽게 설정하고 관리할 수 있게 도와주는 패키지입니다. 이 도구를 사용하면 Android와 iOS 플랫폼에 적합한 해상도의 아이콘을 자동으로 생성할 수 있습니다.

설치 방법 (Installation)

dev_dependencies:
  flutter_launcher_icons: ^0.13.1

flutter_icons:
  android: true
  ios: true
  image_path: "assets/icon/app_icon.png"

pubspec.yaml 파일 수정
프로젝트의 pubspec.yaml 파일에 flutter_launcher_icons를 추가합니다.
여기서 image_path는 런처 아이콘 이미지 파일의 경로를 지정합니다.
패키지 최신 버전 확인
pub.dev에서 최신 버전을 확인하고 적용하세요.

설정 옵션 (Configuration Options)

pubspec.yaml에서 설정 가능한 주요 옵션은 다음과 같습니다.

android: Android 플랫폼에서 아이콘 생성 여부 (true 또는 false)
ios: iOS 플랫폼에서 아이콘 생성 여부 (true 또는 false)
image_path: 기본 아이콘 이미지 파일 경로
image_path_android: Android 전용 아이콘 이미지 경로
image_path_ios: iOS 전용 아이콘 이미지 경로
adaptive_icon_background: Android 적응형 아이콘의 배경 색상 또는 이미지 경로
adaptive_icon_foreground: Android 적응형 아이콘의 전경 이미지 경로

예제 설정은 다음과 같습니다.

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

아이콘 생성 실행 (Run Icon Generation)

pubspec.yaml 파일 설정 후, 다음 명령어를 실행하여 아이콘을 생성합니다.

flutter pub get
flutter pub run flutter_launcher_icons:main

실행이 완료되면 Android와 iOS에 맞는 아이콘이 자동으로 생성되고 설정됩니다.

주의 사항 (Cautions)

사용 이미지 파일은 png 형식을 권장합니다.
고해상도 이미지를 사용하세요. 최소 512×512 픽셀이 이상적입니다.
설정 파일을 수정하기 전에 프로젝트를 백업해 예기치 않은 문제를 방지하세요.

아이콘 변경 및 수정 방법 (Updating Icons)

아이콘을 변경하려면 다음 단계를 따릅니다.

새로운 아이콘 이미지를 준비합니다.
pubspec.yaml 파일에서 이미지 경로를 수정합니다.
아이콘 생성 명령어를 다시 실행합니다.

문제 해결 (Troubleshooting)

아이콘이 적용되지 않거나 오류가 발생할 경우 다음을 확인하세요.

flutter clean 명령어를 실행하고 프로젝트를 다시 빌드합니다.
pubspec.yaml 파일의 구성이 올바른지 확인합니다. 들여쓰기나 옵션 이름이 정확한지 확인하세요.
패키지 버전을 최신으로 업데이트합니다.

참고 자료 (References)

공식 문서 – Flutter Launcher Icons
Flutter 공식 문서

위 과정을 따라 하면 플러터 앱에 맞는 런처 아이콘을 손쉽게 생성할 수 있습니다.

Post Views: 37