variable_app_icon 패키지는 Android 및 iOS 플랫폼에서 앱 아이콘을 동적으로 변경할 수 있도록 해줍니다. 사용자는 런타임 중에 여러 아이콘 간에 전환할 수 있어 개인화와 브랜딩의 유연성을 높입니다. 특정 테마, 이벤트 또는 사용자 선호도를 아이콘으로 반영하고 싶은 앱에 특히 유용합니다. 이 플러그인은 Flutter 프로젝트와 원활하게 통합되며 플랫폼별 아이콘 설정을 지원합니다. 최소한의 설정만 필요하며 표준 자산 관리 방법과 호환됩니다.
사용 사례
사용자 선호도에 기반한 동적 아이콘 전환
특별 이벤트용 테마 앱 아이콘
다중 테넌트 앱에서의 브랜딩 사용자 지정
개인화된 앱 경험
앱 라이프사이클 중 아이콘 변경
주요 기능
Android 및 iOS를 지원합니다
런타임 아이콘 전환
Flutter와의 간편한 통합
다중 아이콘 지원
플랫폼별 구성
적합한 대상
아이콘 맞춤 설정이 필요한 앱
이벤트 기반 또는 계절별 앱 테마
브랜드 앱
사용자 중심 디자인 앱
iOS 및 안드로이드 양쪽을 대상으로 하는 개발자
고려 사항
수동 아이콘 자산 설정이 필요합니다
지원되는 플랫폼에 한정
추가 빌드 단계가 필요할 수 있습니다
정책 제한으로 인해 모든 앱 스토어에 적합하지 않습니다
아이콘 변경 사항이 일부 기기에서는 즉시 반영되지 않을 수 있습니다
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
variable_app_icon
A plugin to use multiple app icon on Android and iOS.
If you don't know yet, you can use multiple app icon in an iOS app from 10.3. in android, you can do this using activity-alias. You can accomplish
this in your flutter app by using this plugin
Getting Started
First, add variable_app_icon as a dependency in your pubspec.yaml file.
dependencies:variable_app_icon:^0.0.1
Don't forget to flutter pub get.
Usage
1. Setting the app icons (Android)
Drop your app icons into mipmap folders. Then configure android/app/src/main/AndroidManifest.xml as follows.
Why this layout? Activity-aliases are how Android serves multiple launcher icons from one APK, but two known issues require extra care:
Flutter's tooling does not properly follow <activity-alias> for flutter run (flutter/flutter#38965). To make flutter run work, MainActivity must declare android:exported="true" (Android 12+ rule, since it is reachable from adb shell am start) and carry a MAIN + LAUNCHER intent-filter in the source manifest. The LAUNCHER category is then stripped at merge time via tools:node="remove" so MainActivity does not appear as a duplicate launcher icon next to the aliases at runtime.
Some OEM launchers (e.g. Huawei) read app metadata from <application> for the uninstall prompt and system dialogs — see issue #5. Keep android:icon and android:label on <application>.
Use this template (replace your_app_name / mipmap names / activity-alias ids as needed):
<manifestxmlns:android="http://schemas.android.com/apk/res/android"xmlns:tools="http://schemas.android.com/tools"><applicationandroid:name="${applicationName}"android:icon="@mipmap/ic_launcher"android:label="your_app_name"><!-- One activity-alias per selectable icon. The id (android:name) must contain at least one dot. --><activity-aliasandroid:name="appicon.DEFAULT"android:enabled="true"android:exported="true"android:icon="@mipmap/ic_launcher"android:label="your_app_name"android:targetActivity=".MainActivity"><intent-filter><actionandroid:name="android.intent.action.MAIN" /><categoryandroid:name="android.intent.category.LAUNCHER" /></intent-filter></activity-alias><!-- Repeat <activity-alias> for each additional icon, with android:enabled="false". --><activityandroid:name=".MainActivity"android:exported="true"android:launchMode="singleTop"android:taskAffinity=""android:theme="@style/LaunchTheme"android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"android:hardwareAccelerated="true"android:windowSoftInputMode="adjustResize"><meta-dataandroid:name="io.flutter.embedding.android.NormalTheme"android:resource="@style/NormalTheme" /><!-- This intent-filter makes `flutter run` work with the activity-alias setup
(flutter/flutter#38965). Flutter's launchable-activity detection reads the
source manifest and needs MainActivity to declare MAIN + LAUNCHER; without
it, `flutter run` cannot locate MainActivity as launchable. If LAUNCHER
survived to runtime, however, MainActivity would appear as a duplicate
launcher icon next to the activity-aliases. `tools:node="remove"` strips
LAUNCHER at manifest-merge time, satisfying both constraints. --><intent-filter><actionandroid:name="android.intent.action.MAIN" /><categoryandroid:name="android.intent.category.LAUNCHER"tools:node="remove" /></intent-filter></activity><meta-dataandroid:name="flutterEmbedding"android:value="2" /></application></manifest>
Notes per icon:
android:name is the icon id (must contain at least one dot — e.g. appicon.DEFAULT, appicon.TEAL). You pass this id from Dart when calling VariableAppIcon.changeAppIcon.
android:enabled="true" on the default icon's alias, android:enabled="false" on the rest.
See example/android/app/src/main/AndroidManifest.xml in this repo for a complete working example with three icons.
2. Setting the app icons (iOS)
Open your ios project i.e. Runner in Xcode, then go to Build Settings tab.
Now search icon, you will find Assets Catalog Compiler Options. Set Include All App Icon
Assets to Yes.
Then add all the icons name to the Alternate App Icon Sets.
3. From the flutter side
In main function set this two variable,
VariableAppIcon.iOSDefaultAppIcon = iosAppIcons[0]; // default ios iconVariableAppIcon.androidAppIconIds = androidIconIds; // all android icons ids, this is the android:name, you have specified in `AndroidManifest.xml` file. like, ["appicon.DEFAULT", others]