Flutter自定义应用图标插件custom_app_logo的使用

Introduction（简介）

什么是custom_app_logo？

此插件用于动态更改Android平台上的应用图标。

为什么使用custom_app_logo？

如果你的应用需要在特定情况下动态更改应用图标，这个插件将非常有用。

Installation（安装）

在pubspec.yaml文件中添加以下依赖：

dependencies:
  custom_app_logo: [latest-version]

Setup and Usage（设置与使用）

以下是使用步骤：

1. 将你的XML图标添加到android/app/src/main/res/...文件夹中。
2. 添加一个新的<activity-alias/>。
3. 在新增的<activity-alias/>中添加图标。

示例代码如下：

<activity
    android:icon="@drawable/ic_yellow"
    android:name=".MainActivity"
    android:enabled="true"
    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"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</activity>
<activity-alias
    android:enabled="true"
    android:icon="@drawable/ic_green"
    android:exported="true"
    android:targetActivity=".MainActivity"
    android:name=".SecondActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity-alias>

注意：你需要在<activity android:name=".MainActivity"/>中包含一个图标。

1. 调用函数：

await _customAppLogoPlugin.getActivities();

这将返回一个List<ActivityModel>。

1. 每个ActivityModel包含以下内容：

class ActivityModel {
  final String activtiyName;

  final Uint8List activtiyLogo;

  final VoidCallback onChangeActivtiyLogo;

  ActivityModel({required this.activtiyName, required this.activtiyLogo, required this.onChangeActivtiyLogo});
}

只需调用onChangeActivtiyLogo回调函数即可更改图标。

注意：iOS的实现将在以后添加。

Example（示例）

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

import 'package:custom_app_logo/activityModel.dart';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:custom_app_logo/custom_app_logo.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _customAppLogoPlugin = CustomAppLogo();
  List<ActivityModel> _activties = [];

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 异步初始化平台状态
  Future<void> initPlatformState() async {
    final result = await _customAppLogoPlugin.getActivities();
    setState(() {
      _activties = result;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: ListView.builder(
            itemCount: _activties.length,
            itemBuilder: (context, index) {
              return ListTile(
                onTap: () => showDialog(
                  context: context,
                  builder: (context) => Dialog(
                    child: Padding(
                      padding: EdgeInsets.all(30),
                      child: Column(
                        mainAxisSize: MainAxisSize.min,
                        children: [
                          const Text(
                            "Are you sure you want to change to this Logo ?",
                            style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
                          ),
                          Row(
                            children: [
                              TextButton(
                                onPressed: () {
                                  _activties[index].onChangeActivtiyLogo();
                                  Navigator.pop(context);
                                },
                                child: Text("OK"),
                              ),
                              TextButton(
                                onPressed: () => Navigator.pop(context),
                                child: Text("Cancel"),
                              ),
                            ],
                          )
                        ],
                      ),
                    ),
                  ),
                ),
                title: Text(_activties[index].activtiyName, style: TextStyle(fontSize: 14),),
                leading: Image.memory(_activties[index].activtiyLogo),
              );
            },
          ),
        ),
      ),
    );
  }
}