Flutter应用图标管理插件flutter_app_icons的使用

flutter_app_icons 插件允许开发者在Flutter应用程序中动态地更改应用图标。无论是Web还是Android平台，你都可以通过编程方式改变你的favicon或应用图标。

Web版本使用方法

对于Web版本来说，操作相对简单：

1. 创建一个 FlutterAppIcons 对象实例。
2. 在你需要更改favicon的地方调用 setIcon 方法。

final _flutterAppIconsPlugin = FlutterAppIcons();

// 更改favicon
_flutterAppIconsPlugin.setIcon(icon: 'favicon.png');

Android版本使用方法

Android端的操作稍微复杂一些，需要按照以下步骤进行：

Step 1: 修改AndroidManifest.xml

更新你的AndroidManifest.xml文件中的主活动（MainActivity），将原有的LAUNCHER类别改为LEANBACK_LAUNCHER:

<category android:name="android.intent.category.LEANBACK_LAUNCHER"/>

Step 2: 添加activity-alias

为每个想要使用的图标添加对应的activity-alias配置。注意：图标名称需要符合Java类名规范，在这里以点号分隔路径部分。

<activity-alias 
    android:label="flutter_app_icons_example"
    android:icon="@mipmap/ic_launcher_f_round" 
    android:name=".favicon.png" 
    android:exported="true" 
    android:enabled="false" 
    android:targetActivity=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity-alias>

<activity-alias 
    android:label="flutter_app_icons_example" 
    android:icon="@mipmap/ic_launcher" 
    android:name=".favicon.failure.png" 
    android:exported="true" 
    android:enabled="true" 
    android:targetActivity=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity-alias>

Step 3: 使用API更改图标

创建 FlutterAppIcons 对象，并调用 setIcon 方法来更改图标，同时指定当前激活的旧图标名称。

final _flutterAppIconsPlugin = FlutterAppIcons();

// 更改应用图标，同时指定旧图标
_flutterAppIconsPlugin.setIcon(icon: 'favicon.png', oldIcon: 'favicon-failure.png');

Step 4: 解决Flutter无法识别的问题

由于移除了LAUNCHER类别并且增加了activity-alias，Flutter可能无法直接运行你的代码。你需要打开android/src/main/(java OR kotlin)/your_package_name/ClassName，然后点击顶部的通知“Open for Editing In Android Studio”，再从那里执行任何你需要的操作（如运行、发布等）。

示例代码

下面是一个完整的示例代码，展示了如何在Flutter应用中使用flutter_app_icons插件来切换应用图标：

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_app_icons/flutter_app_icons.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _flutterAppIconsPlugin = FlutterAppIcons();
  String _icon = 'favicon.png';
  Timer? _autoChange;

  @override
  void initState() {
    super.initState();
  }

  // 每隔两秒自动切换图标
  void startTimer() {
    final Timer timer =
        Timer.periodic(const Duration(seconds: 2), (Timer timer) {
      final String nextIcon = getOldIcon(_icon);
      setIcon(nextIcon);
    });
    setState(() {
      _autoChange = timer;
    });
  }

  // 停止自动切换图标
  void stopTimer() {
    _autoChange?.cancel();
    setState(() {
      _autoChange = null;
    });
  }

  // 设置图标
  void setIcon(String? nextIcon) {
    if (nextIcon == null) return;
    _flutterAppIconsPlugin.setIcon(
      icon: nextIcon,
      oldIcon: getOldIcon(nextIcon),
    );
    setState(() {
      _icon = nextIcon;
    });
  }

  // 获取旧图标名称
  String getOldIcon(String icon) {
    if (icon == 'favicon.png') {
      return 'favicon-failure.png';
    }
    return 'favicon.png';
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('FlutterAppIcons example'),
          surfaceTintColor: Theme.of(context).colorScheme.primary,
        ),
        body: Center(
          child: Container(
            constraints: const BoxConstraints(maxWidth: 500),
            child: ListView(
              shrinkWrap: true,
              children: [
                const ListTile(
                  title: Text('Select favicon:'),
                ),
                RadioListTile<String>(
                  value: 'favicon.png',
                  groupValue: _icon,
                  onChanged: _autoChange == null ? setIcon : null,
                  title: const Text(
                    'Blue',
                    style: TextStyle(color: Colors.blue),
                  ),
                ),
                RadioListTile<String>(
                  value: 'favicon-failure.png',
                  groupValue: _icon,
                  onChanged: _autoChange == null ? setIcon : null,
                  title: const Text(
                    'Red',
                    style: TextStyle(color: Colors.red),
                  ),
                ),
                const ListTile(
                  title: Text('Automatic mode:'),
                ),
                SwitchListTile(
                  title: const Text('Change every 2 seconds'),
                  value: _autoChange != null,
                  onChanged: (bool value) {
                    if (value) {
                      startTimer();
                    } else {
                      stopTimer();
                    }
                  },
                )
              ],
            ),
          ),
        ),
      ),
    );
  }
}

这个例子展示了如何通过用户交互或定时器来切换应用图标，以及如何处理图标之间的切换逻辑。希望这对您有所帮助！