如何在Flutter应用中实现用户自定义应用名称与图标功能？

由于应用的名称和图标属于系统级配置，Flutter本身无法直接动态修改，需要结合Android和iOS的原生能力实现。以下是分平台的具体方案、代码示例及最佳实践。

一、自定义应用图标 #

Android：使用Activity Alias #

通过配置多个activity-alias，每个别名对应不同的图标和名称，切换时启用目标别名并禁用其他别名。

1. 配置AndroidManifest.xml

在application标签内添加主Activity和备用别名：

<application
    android:label="@string/app_name"
    android:icon="@mipmap/ic_launcher">

    <!-- 主Activity -->
    <activity
        android:name=".MainActivity"
        android:exported="true">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>

    <!-- 自定义别名1 -->
    <activity-alias
        android:name=".CustomAlias1"
        android:exported="true"
        android:label="我的应用1"
        android:icon="@mipmap/custom_icon1"
        android:targetActivity=".MainActivity">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity-alias>

    <!-- 自定义别名2 -->
    <activity-alias
        android:name=".CustomAlias2"
        android:exported="true"
        android:label="我的应用2"
        android:icon="@mipmap/custom_icon2"
        android:targetActivity=".MainActivity">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity-alias>

</application>

2. 原生代码实现切换

在MainActivity.kt中通过MethodChannel处理Flutter的调用：

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.example.custom_app_settings"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            when (call.method) {
                "switchToAlias" -> {
                    val aliasName = call.argument<String>("aliasName") ?: run {
                        result.error("INVALID_ARG", "Alias name required", null)
                        return@setMethodCallHandler
                    }
                    switchAlias(aliasName)
                    result.success(true)
                }
                else -> result.notImplemented()
            }
        }
    }

    private fun switchAlias(targetAlias: String) {
        val pm = packageManager
        // 禁用所有启动组件
        listOf(".MainActivity", ".CustomAlias1", ".CustomAlias2").forEach { component ->
            val cmp = ComponentName(packageName, "$packageName$component")
            pm.setComponentEnabledSetting(
                cmp,
                PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
                PackageManager.DONT_KILL_APP
            )
        }
        // 启用目标别名
        val targetCmp = ComponentName(packageName, "$packageName$targetAlias")
        pm.setComponentEnabledSetting(
            targetCmp,
            PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
            PackageManager.DONT_KILL_APP
        )
        // 重启应用生效
        pm.getLaunchIntentForPackage(packageName)?.let {
            it.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP)
            startActivity(it)
        }
    }
}

iOS：使用Alternate Icons #

利用iOS官方提供的Alternate Icons能力，切换应用图标。

1. 配置Info.plist

添加CFBundleIcons配置，定义主图标和备用图标：

<key>CFBundleIcons</key>
<dict>
    <key>CFBundlePrimaryIcon</key>
    <dict>
        <key>CFBundleIconFiles</key>
        <array>
            <string>AppIcon</string>
        </array>
    </dict>
    <key>CFBundleAlternateIcons</key>
    <dict>
        <key>CustomIcon1</key>
        <dict>
            <key>CFBundleIconFiles</key>
            <array>
                <string>CustomIcon1</string>
            </array>
        </dict>
        <key>CustomIcon2</key>
        <dict>
            <key>CFBundleIconFiles</key>
            <array>
                <string>CustomIcon2</string>
            </array>
        </dict>
    </dict>
</dict>

2. 原生代码实现切换

在AppDelegate.swift中处理Flutter调用：

import UIKit
import Flutter

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    let CHANNEL = "com.example.custom_app_settings"

    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        GeneratedPluginRegistrant.register(with: self)
        
        guard let controller = window?.rootViewController as? FlutterViewController else {
            return super.application(application, didFinishLaunchingWithOptions: launchOptions)
        }
        
        let channel = FlutterMethodChannel(name: CHANNEL, binaryMessenger: controller.binaryMessenger)
        channel.setMethodCallHandler { call, result in
            switch call.method {
            case "setAlternateIcon":
                guard let iconName = call.arguments as? String else {
                    result.error("INVALID_ARG", "Icon name required", nil)
                    return
                }
                UIApplication.shared.setAlternateIconName(iconName) { error in
                    if let error = error {
                        result.error("ICON_ERROR", error.localizedDescription, nil)
                    } else {
                        result.success(true)
                    }
                }
            default:
                result.notImplemented()
            }
        }
        
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

二、自定义应用名称 #

Android：结合Activity Alias实现 #

直接在activity-alias的android:label属性中定义自定义名称，切换别名时自动更新桌面名称（无需额外代码，复用上述图标切换逻辑即可）。

如果需要支持用户输入任意名称（而非预设值），可以通过动态修改字符串资源的方式实现，但需注意：

• 需将字符串资源放在可写目录（如files目录）
• 重启应用后生效
• 兼容性较差，建议优先使用预设别名方案

iOS：快捷方式替代方案 #

iOS无法直接修改原应用的桌面名称（Info.plist为只读），可通过创建自定义快捷方式实现：

1. 原生代码实现

在AppDelegate.swift中添加快捷方式创建逻辑：

private func createCustomShortcut(with name: String) {
    guard let icon = INImage(systemImageName: "app.fill") else { return }
    let shortcut = INShortcut(intent: INIntent())
    shortcut.shortcutTitle = name
    shortcut.icon = icon
    INVoiceShortcutCenter.shared.setShortcutSuggestions([shortcut])
    // 提示用户手动将快捷方式添加到主屏幕
    let alert = UIAlertController(
        title: "提示",
        message: "请前往「快捷指令」应用，将自定义快捷方式添加到主屏幕",
        preferredStyle: .alert
    )
    alert.addAction(UIAlertAction(title: "知道了", style: .default))
    window?.rootViewController?.present(alert, animated: true)
}

然后在MethodChannel中添加对应方法：

case "createCustomShortcut":
    guard let appName = call.arguments as? String else {
        result.error("INVALID_ARG", "App name required", nil)
        return
    }
    createCustomShortcut(with: appName)
    result.success(true)

三、Flutter层调用代码 #

创建统一的工具类封装原生调用：

import 'package:flutter/services.dart';

class AppCustomizer {
  static const MethodChannel _channel = MethodChannel('com.example.custom_app_settings');

  /// Android：切换到指定别名（同时更新图标和名称）
  static Future<bool> switchToAndroidAlias(String aliasName) async {
    try {
      return await _channel.invokeMethod('switchToAlias', {'aliasName': aliasName});
    } on PlatformException catch (e) {
      throw Exception('切换失败: ${e.message}');
    }
  }

  /// iOS：切换到指定备用图标
  static Future<bool> setIOSAlternateIcon(String iconName) async {
    try {
      return await _channel.invokeMethod('setAlternateIcon', {'iconName': iconName});
    } on PlatformException catch (e) {
      throw Exception('切换图标失败: ${e.message}');
    }
  }

  /// iOS：创建自定义名称的快捷方式
  static Future<bool> createIOSCustomShortcut(String appName) async {
    try {
      return await _channel.invokeMethod('createCustomShortcut', {'appName': appName});
    } on PlatformException catch (e) {
      throw Exception('创建快捷方式失败: ${e.message}');
    }
  }
}

在UI中调用示例：

ElevatedButton(
  onPressed: () async {
    await AppCustomizer.switchToAndroidAlias('.CustomAlias1');
  },
  child: const Text('切换到自定义样式1'),
),
ElevatedButton(
  onPressed: () async {
    await AppCustomizer.setIOSAlternateIcon('CustomIcon1');
  },
  child: const Text('切换图标1'),
),
ElevatedButton(
  onPressed: () async {
    await AppCustomizer.createIOSCustomShortcut('我的专属应用');
  },
  child: const Text('设置自定义名称'),
),

四、最佳实践 #

Android #

• 提前配置所有预设的activity-alias，避免动态创建组件的复杂性
• 切换后必须重启应用，需给用户明确提示
• 确保图标符合Android各版本的尺寸规范（如mdpi、hdpi等）
• 测试Android 12+的图标自适应效果

iOS #

• 备用图标必须严格符合苹果的尺寸要求，否则切换会失败
• 切换图标时系统会自动弹出提示，无法完全隐藏（切换回主图标除外）
• 自定义名称仅能通过快捷方式实现，需清晰告知用户操作步骤
• 确保Info.plist的图标配置正确，避免出现找不到图标的错误

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