Flutter应用启动器切换插件launcher_switch的使用

Getting Started

在你的pubspec.yaml文件中添加launcher_switch作为依赖项：

dependencies:
    launcher_switch: ^<最新版本>

配置

首先，在你的AndroidManifest.xml文件中添加各种图标作为activity-alias标签。例如：

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application
        android:label="{YOUR_APPLICATION_NAME}"
        android:name="${applicationName}">
        <!-- 这是你默认的图标 -->
        <activity
            android:name=".MainActivity"
            android:exported="true"
            android:launchMode="singleTop"
            android:theme="@style/LaunchTheme"
            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
            android:hardwareAccelerated="true"
            android:windowSoftInputMode="adjustResize">
            <meta-data
              android:name="io.flutter.embedding.android.NormalTheme"
              android:resource="@style/NormalTheme"
              />
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>

        <!-- 添加你的activity-alias标签 -->
        <activity-alias
            <!-- 在这种情况下，名称为.Icon2 -->
            android:name=".Icon2"
            android:exported="true"
            android:enabled="false"
            android:hardwareAccelerated="true"
            android:icon="@mipmap/ic_launcher_2"
            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标签 -->

        <meta-data
            android:name="flutterEmbedding"
            android:value="2" />
    </application>
</manifest>

需要注意的是：

• application标签下的android:icon是默认图标。
• 所有的activity-alias标签必须通过android:targetActivity指向MainActivity。
• 设置所有添加的activity-alias标签的android:enabled为false。
• Android系统不会存储当前活动/别名的名称，因此建议使用SharedPreferences或其他持久化存储来避免问题。
• 确保在manifest文件中定义了所有的图标键。
• 确保android:icon在res/mipmap目录中为每个别名创建（在这种情况下，第二个启动器图标是@mipmap/ic_launcher_2）。
• 各个activity-alias的名称必须以点开头（如.Icon2, .IconAlias, .SecondActivity等）。

使用

1. 导入并创建一个LauncherSwitch实例：

import 'package:launcher_switch/launcher_switch.dart';

final switcher = LauncherSwitch();

1. 调用switchIcon函数来更改图标。假设这是你刚刚安装的应用程序，那么previousIconKey参数应为.MainActivity，而iconKey参数应为你的AndroidManifest.xml文件中任何别名的android:name属性（在这种情况下，它应该是.Icon2）：

switcher.switchIcon(
    iconKey: ".Icon2",
    previousIconKey: ".MainActivity",
);

如果你想再次更改回主图标，之前的图标将是.Icon2，然后你可以使用别名的name属性设置新的图标。如果你想要更改回主图标，可以这样做：

switcher.switchIcon(
    previousIconKey: ".Icon2", // 这在你的情况下会有所不同
    iconKey: ".MainActivity",
);

重要提示

执行此功能后应用程序将关闭以便刷新图标，所以在调用此功能之前确保所有数据都已保存好。

示例代码

以下是一个完整的示例代码：

import 'package:flutter/material.dart';
import 'package:launcher_switch/launcher_switch.dart';

final launcherSwitch = LauncherSwitch();

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatelessWidget {
  const HomeScreen({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("启动器切换"),
        backgroundColor: Theme.of(context).primaryColor,
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () {
                launcherSwitch.switchIcon(
                  iconKey: ".Icon2",
                  previousIconKey: ".MainActivity",
                );
              },
              child: const Text("切换图标"),
            ),
          ],
        ),
      ),
    );
  }
}