Flutter图标切换插件mobile_icon_switcher的使用

Mobile Icon Switcher 是一个使应用程序能够在应用内部轻松更改图标的插件。以下是简短的演示：

演示

如何使用

iOS

前提条件

• 重要：此包不处理初始应用程序图标。必须自行提供或设置。
• iOS 10.3及以上版本。
• 图片大小为@1x, @2x, 和 @3x，就像标准的iOS图像一样。可以使用以下工具进行处理：这里（也可用于Android）。

准备工作

1. 在XCode中打开项目中的Runner.xcworkspace。
2. 在Runner文件夹中创建一个名为App Icons的文件夹。
3. 将你的应用图标放入该文件夹，分别命名为Name[@1x](/user/1x).png, Name[@2x](/user/2x).png, 和 Name[@3x](/user/3x).png。

然后，修改info.plist文件，如示例所示：

...
<key>CFBundleIcons</key>
    <dict>
        <key>CFBundleAlternateIcons</key>
        <dict>
            <key>NAME</key>
            <dict>
                <key>UIPrerenderedIcon</key>
                <string>NO</string>
                <key>CFBundleIconFiles</key>
                <array>
                    <string>NAME</string>
                </array>
            </dict>
            <key>NAME2</key>
            <dict>
                <key>UIPrerenderedIcon</key>
                <string>NO</string>
                <key>CFBundleIconFiles</key>
                <array>
                    <string>NAME2</string>
                </array>
            </dict>
        </dict>
    </dict>
...

将NAME和NAME2替换为你实际的应用图标文件名。

完成后，你就可以开始使用了！

Android

前提条件

• 重要：Android 默认不提供通过代码更改应用图标的解决方案，因此这种方法可能不是最干净和最好的，但它是有效的。
• 你需要知道你的applicationId，默认为：com.example.example。
• 图片格式为mipmap，就像默认的Android图标一样。可以使用以下工具进行处理：这里（也可以用于iOS）。

准备工作

1. 将你的图片放入目标文件夹：your_project/android/app/src/main/res/mipmap-anydpi-v26, your_project/android/app/src/main/res/mipmap-hdpi, your_project/android/app/src/main/res/mipmap-mdpi, your_project/android/app/src/main/res/mipmap-xhdpi, your_project/android/app/src/main/res/mipmap-xxhdpi 和 your_project/android/app/src/main/res/mipmap-xxxhdpi。

2. 打开your_project/android/app/src/main/AndroidManifest.xml文件，并为每个图标添加一个条目，如下所示：

...
        </activity>
        <!--START HERE: -->
        <activity-alias
            android:name=".NameOfYourActivity"
            android:targetActivity=".MainActivity"
            android:icon="@mipmap/NameOfTheMipMapImage"
            android:enabled="false">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity-alias>
        ...

NameOfTheMipMapImage必须是你放置在mipmap文件夹中的图片名称（请参考我的示例）。

NameOfYourActivity非常重要！因为现在我们需要在Android项目中创建一个活动类。我编辑了your_project/android/app/src/main/kotlin/com/example/example/MainActivity.kt文件，在这个文件中，你需要创建与你在NameOfYourActivity中指定的名称相同的新活动类。

示例

我的AndroidManifest.xml：

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application
        android:label="example"
        android:name="${applicationName}"
        android:icon="@mipmap/ic_launcher">
        <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">
            <!-- Specifies an Android theme to apply to this Activity as soon as
                 the Android process has started. This theme is visible to the user
                 while the Flutter UI initializes. After that, this theme continues
                 to determine the Window background behind the Flutter UI. -->
            <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>
        <!--IMPORTANT START HERE: -->
        <activity-alias
            android:name=".First"
            android:targetActivity=".MainActivity"
            android:icon="@mipmap/first"
            android:enabled="false">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity-alias>
        <!-- Don't delete the meta-data below.
             This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
        <meta-data
            android:name="flutterEmbedding"
            android:value="2" />
    </application>
</manifest>

可以看到，我需要创建一个名为First的类，如下所示：

package com.example.example

import io.flutter.embedding.android.FlutterActivity

class MainActivity: FlutterActivity() {
}

//NEW:
class First: FlutterActivity() {
}

Flutter/Dart部分

不幸的是，对于Android我们还需要设置一些不同的东西：

MobileIconSwitcher.setDefaultComponent("com.example.example.MainActivity");

当我们启动应用时需要调用这个方法，请也查看我的示例应用是如何实现的。重要的是，applicationId和MainActivity的名称必须正确，请在出错的情况下仔细检查。

在Flutter应用中使用mobile_icon_switcher

切换应用图标

完成上述iOS和/或Android设置后，你可以通过调用以下方法来切换应用图标：

await MobileIconSwitcher.changeIcon('first', 'com.example.example.First');

这里的第一个参数是图标名称，这对于iOS来说是必要的，第二个参数是带有Android应用ID的活动。

重置应用图标到默认值

完成上述iOS和/或Android设置后，你可以通过调用以下方法将应用图标重置为默认值：

await MobileIconSwitcher.resetIcon();