如何为已上线的Flutter移动端应用动态更新应用图标？

核心前提：原生系统不允许完全动态生成并替换未预先打包的图标，所有可切换的图标必须提前预埋到上线安装包中，再通过系统API切换。以下是分平台的具体实现方案：

iOS 端实现 #

1. 预埋备选图标与配置

   • 在Xcode项目的Info.plist中添加CFBundleAlternateIcons字段，定义每个备选图标的标识和对应资源：

     <key>CFBundleAlternateIcons</key>
     <dict>
         <key>HolidayIcon</key>
         <dict>
             <key>CFBundleIconFiles</key>
             <array>
                 <string>holiday_icon</string>
             </array>
             <key>UIPrerenderedIcon</key>
             <false/>
         </dict>
     </dict>
     

   • 将备选图标文件（如不同尺寸的holiday_icon.png）添加到项目中，避免放入默认的AppIcon资产目录。

2. 原生与Flutter通信
   通过MethodChannel实现切换逻辑，Swift示例代码：

   import UIKit
   import Flutter
   
   class IconMethodHandler: NSObject, FlutterMethodCallHandler {
       func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
           guard let args = call.arguments as? [String: String],
                 let iconName = args["iconName"] else {
               result(FlutterError(code: "ARG_ERROR", message: "Missing icon name", details: nil))
               return
           }
           
           guard UIApplication.shared.supportsAlternateIcons else {
               result(FlutterError(code: "UNSUPPORTED", message: "Alternate icons not supported", details: nil))
               return
           }
           
           UIApplication.shared.setAlternateIconName(iconName) { error in
               result(error != nil ? FlutterError(code: "FAIL", message: error!.localizedDescription, details: nil) : nil)
           }
       }
   }
   

3. 注意事项

   • iOS系统会在图标切换时弹出默认提示框，无法自定义隐藏
   • 所有备选图标必须通过App Store审核，不可在上线后新增未预埋的图标

Android 端实现 #

1. 配置Activity别名与图标
   在AndroidManifest.xml中为主Activity添加多个<activity-alias>，每个别名对应一个备选图标：

   <activity android:name=".MainActivity">
       <intent-filter>
           <action android:name="android.intent.action.MAIN" />
           <category android:name="android.intent.category.LAUNCHER" />
       </intent-filter>
   </activity>
   
   <activity-alias
       android:name=".HolidayIconAlias"
       android:enabled="false"
       android:icon="@drawable/holiday_icon"
       android:roundIcon="@drawable/holiday_icon_round"
       android:targetActivity=".MainActivity">
       <intent-filter>
           <action android:name="android.intent.action.MAIN" />
           <category android:name="android.intent.category.LAUNCHER" />
       </intent-filter>
   </activity-alias>
   

   • 主Activity默认保持启用状态，别名Activity默认设为android:enabled="false"

2. 原生与Flutter通信
   通过MethodChannel切换启用的Activity别名，Kotlin示例代码：

   import android.content.pm.PackageManager
   import io.flutter.embedding.android.FlutterActivity
   import io.flutter.embedding.engine.FlutterEngine
   import io.flutter.plugin.common.MethodChannel
   
   class MainActivity : FlutterActivity() {
       private val CHANNEL = "com.yourapp.icon/changer"
   
       override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
           super.configureFlutterEngine(flutterEngine)
           MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
               if (call.method == "changeIcon") {
                   val aliasName = call.argument<String>("aliasName") ?: run {
                       result.error("ARG_ERROR", "Missing alias name", null)
                       return@setMethodCallHandler
                   }
                   try {
                       // 禁用主Activity的启动器标识
                       packageManager.setComponentEnabledSetting(
                           componentName,
                           PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
                           PackageManager.DONT_KILL_APP
                       )
                       // 启用目标别名Activity
                       packageManager.setComponentEnabledSetting(
                           android.content.ComponentName(packageName, aliasName),
                           PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
                           PackageManager.DONT_KILL_APP
                       )
                       result.success(null)
                   } catch (e: Exception) {
                       result.error("FAIL", e.localizedMessage, null)
                   }
               } else {
                   result.notImplemented()
               }
           }
       }
   }
   

3. 注意事项

   • 切换图标后应用会重启，建议提前保存用户状态
   • 部分国产ROM可能对Activity别名切换有额外限制，需测试适配

Flutter 层统一调用封装 #

创建工具类简化跨平台调用：

import 'package:flutter/services.dart';

class AppIconManager {
  static const _channel = MethodChannel('com.yourapp.icon/changer');

  static Future<void> switchToIcon({required String identifier}) async {
    try {
      await _channel.invokeMethod('changeIcon', {
        'iconName': identifier, // 对应iOS的备选图标标识
        'aliasName': "com.yourapp.$identifier", // 对应Android的Activity别名全路径
      });
    } on PlatformException catch (e) {
      throw Exception('Icon switch failed: ${e.message}');
    }
  }
}

核心限制总结 #

• 所有可切换图标必须提前打包到上线版本中，无法在运行时新增未预埋的图标
• iOS强制弹出切换提示，Android切换会触发应用重启
• 备选图标需符合平台规范，避免审核被拒

内容的提问来源于stack exchange，提问作者Chintala Santhosh