Flutter · Android 런처 아이콘

앱 아이콘 파일 위치

폰 홈 화면에 뜨는 아이콘은 어댑티브 아이콘입니다. 실제로 설치되는 건 빌드로 생성된 리소스이고, 그 원본은 assets/icons/에 있습니다. 이 원본을 바꾸고 재생성하면 아이콘이 교체됩니다.

auto_schedule_app · 하루계획 day_plan_app · 하루계획(광고포함) 경로·구조 동일

▸ 어댑티브 아이콘은 배경 + 전경 두 겹

배경
#FFFFFF

🗓

전경
inset 25%

🗓

홈 화면
아이콘

매니페스트가 android:icon="@mipmap/ic_launcher"를 가리키고, 그 정의(ic_launcher.xml)가 배경 색과 전경 그림을 합쳐 아이콘을 만듭니다.

1 실제 폰에 들어가는 파일 (빌드 생성물)

경로 기준: android/app/src/main/res/ · 아래는 자동 생성되는 리소스라 직접 수정하지 말 것.

정의 XML

mipmap-anydpi-v26/ic_launcher.xml

배경·전경을 합치는 어댑티브 아이콘 정의 (API 26+).

배경색

values/colors.xml → ic_launcher_background = #FFFFFF

전경 그림생성

drawable-{m,h,xh,xxh,xxx}dpi/ic_launcher_foreground.png

해상도별 5개. 어댑티브 아이콘의 앞면(inset 25%).

구형 단말생성

mipmap-{m,h,xh,xxh,xxx}dpi/ic_launcher.png

어댑티브 미지원 단말용 통짜 아이콘. 해상도별 5개.

2 원본 소스 (이걸 바꾼다)

경로 기준: 프로젝트 루트. pubspec.yaml의 flutter_launcher_icons 설정이 위 1번 리소스를 이 원본에서 생성합니다.

전체 아이콘원본

assets/icons/cal_todo.png

전경 원본원본

assets/icons/cal_todo_foreground.png

# pubspec.yaml — 아이콘 생성 설정
flutter_launcher_icons:
  android: true
  ios: false
  image_path: assets/icons/cal_todo.png
  adaptive_icon_foreground: assets/icons/cal_todo_foreground.png
  adaptive_icon_background: "#FFFFFF"
  adaptive_icon_foreground_inset: 25   # 클수록 전경↓(안전영역 안). 18→25

ℹ

inset = 전경 크기 조절. 값이 클수록 전경(아이콘 그림)이 작아져 어댑티브 마스크 안전영역 안에 들어옵니다. 바깥 네모 박스가 잘리거나 아이콘을 벗어나면 inset을 키우세요(예: 18 → 25). 너무 작아 보이면 다시 낮춤. 변경 후 flutter pub run flutter_launcher_icons 재생성 + 재빌드.

3 아이콘 교체 방법

원본 교체 — assets/icons/cal_todo.png(및 cal_todo_foreground.png)를 새 그림으로 덮어쓰기. 배경색·inset을 바꾸려면 pubspec의 adaptive_icon_background·..._inset 수정.
리소스 재생성 — 아래 명령으로 mipmap/drawable 자동 갱신.
재빌드 — flutter build apk --debug 후 설치하면 폰 아이콘이 바뀜.

# 프로젝트 루트에서 (두 앱 각각 실행)
flutter pub run flutter_launcher_icons
# (신버전은) dart run flutter_launcher_icons

ℹ

두 앱은 별개 프로젝트입니다. 같은 원본을 쓰더라도 auto_schedule_app·day_plan_app에서 각각 원본 교체 → 재생성 → 재빌드를 해야 합니다. 앱 이름(label)은 각각 하루계획 / 하루계획(광고제거). inset도 앱별로 각각 조정·재생성.