一、插件介绍

fluttertpc_flutter_app_badge 是一款用于更新应用图标徽章（角标）的 Flutter 插件，专门为 HarmonyOS 平台进行了适配。该插件可以帮助开发者轻松设置应用图标上的数字徽章，用于显示未读消息数量、通知数量等重要信息，提升应用的用户体验。

核心功能

• 设置徽章数量：轻松设置应用图标上的数字徽章
• 清除徽章：将徽章数量设置为 0 以清除徽章
• 跨平台兼容：支持 iOS 和 HarmonyOS 平台
• 简单易用：提供简洁的 API 接口，易于集成和使用

二、安装与配置

2.1 环境要求

• Flutter: 3.7.12-ohos-1.1.3 或 3.22.1-ohos-1.0.3
• HarmonyOS SDK: 5.0.0(12)
• DevEco Studio: 5.1.0.828

2.2 依赖配置

在项目的 pubspec.yaml 文件中添加以下依赖配置：

dependencies:
  flutter_app_badge_ohos:
    git:
      url: "https://atomgit.com/openharmony-sig/fluttertpc_flutter_app_badge.git"
      path: "ohos"

然后执行以下命令获取依赖：

flutter pub get

三、API 使用指南

3.1 导入包

import 'package:flutter_app_badge_ohos/flutter_app_badge_ohos.dart';

3.2 设置徽章数量

使用 count 方法设置应用图标上的徽章数量：

// 设置徽章数量为 5
FlutterAppBadge.count(5);

3.3 清除徽章

将徽章数量设置为 0 以清除徽章：

// 清除徽章
FlutterAppBadge.count(0);

3.4 处理负数

如果传入负数，插件会自动将其转换为 0：

// 负数会被转换为 0，即清除徽章
FlutterAppBadge.count(-10);

四、完整示例

以下是一个完整的 HarmonyOS 平台使用示例：

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter App Badge 示例',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter App Badge 示例'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _badgeCount = 0;

  // 设置徽章数量
  void _setBadgeCount(int count) {
    setState(() {
      _badgeCount = count;
    });
    FlutterAppBadge.count(count);
  }

  // 增加徽章数量
  void _incrementBadge() {
    _setBadgeCount(_badgeCount + 1);
  }

  // 减少徽章数量
  void _decrementBadge() {
    _setBadgeCount(_badgeCount > 0 ? _badgeCount - 1 : 0);
  }

  // 清除徽章
  void _clearBadge() {
    _setBadgeCount(0);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              '当前徽章数量:',
              style: TextStyle(fontSize: 20),
            ),
            SizedBox(height: 10),
            Text(
              '$_badgeCount',
              style: TextStyle(fontSize: 48, fontWeight: FontWeight.bold),
            ),
            SizedBox(height: 30),
            Row(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                ElevatedButton(
                  onPressed: _decrementBadge,
                  child: Text('-'),
                  style: ElevatedButton.styleFrom(
                    padding: EdgeInsets.all(20),
                    textStyle: TextStyle(fontSize: 24),
                  ),
                ),
                SizedBox(width: 20),
                ElevatedButton(
                  onPressed: _incrementBadge,
                  child: Text('+'),
                  style: ElevatedButton.styleFrom(
                    padding: EdgeInsets.all(20),
                    textStyle: TextStyle(fontSize: 24),
                  ),
                ),
              ],
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _clearBadge,
              child: Text('清除徽章'),
              style: ElevatedButton.styleFrom(
                padding: EdgeInsets.symmetric(horizontal: 30, vertical: 15),
                textStyle: TextStyle(fontSize: 18),
              ),
            ),
          ],
        ),
      ),
    );
  }
}

五、HarmonyOS 平台注意事项

5.1 权限配置

在 HarmonyOS 平台上，使用 fluttertpc_flutter_app_badge 插件不需要特殊的权限配置。

5.2 徽章显示效果

徽章会显示在应用图标的右上角，显示当前设置的数字。当数字为 0 时，徽章会自动隐藏。

5.3 兼容性

该插件已在以下环境中测试通过：

• Flutter: 3.7.12-ohos-1.1.3 和 3.22.1-ohos-1.0.3
• HarmonyOS SDK: 5.0.0(12)
• DevEco Studio: 5.1.0.828

六、常见问题与解决方案

6.1 徽章不显示

如果徽章不显示，可能是以下原因：

1. 数字为 0：当设置的数字为 0 时，徽章会自动隐藏
2. 平台限制：某些 HarmonyOS 设备或版本可能不支持应用徽章功能
3. 插件未正确导入：确保已正确导入包并获取依赖

6.2 徽章数量不正确

如果徽章数量不正确，可能是以下原因：

1. 负数处理：插件会自动将负数转换为 0
2. 状态管理问题：确保应用内部状态与徽章数量保持同步

七、总结

fluttertpc_flutter_app_badge 是一款功能简单但实用的应用徽章插件，为 HarmonyOS 平台提供了便捷的徽章设置能力。其主要优势包括：

1. 简单易用：提供简洁的 API 接口，只需一行代码即可设置徽章数量
2. 轻量级：插件体积小，不影响应用性能
3. 跨平台兼容：同时支持 iOS 和 HarmonyOS 平台
4. 智能处理：自动处理负数情况，将其转换为 0
5. 无需权限：在 HarmonyOS 平台上无需特殊权限配置

该插件可以帮助开发者轻松实现应用图标徽章功能，用于显示未读消息数量、通知数量等重要信息，提升应用的用户体验和互动性。

---

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net