Buscar pacotes, repositórios e categorias de apps

Capa de app_badge_plus
Detalhes do pacotev1.4.0

app_badge_plus

Um plugin Flutter para adicionar selos ao ícone do seu aplicativo. Suporta iOS, Android e macOS.

AndroidiOSmacOS
Downloads em 30 dias
381 mil
Curtidas
172
Pontos Pub
160

Instalar pacote

flutter pub add app_badge_plus

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

AppBadgePlus é um plugin Flutter que permite aos desenvolvedores exibir badges no ícone do aplicativo em plataformas Android, iOS e macOS. Ele fornece uma API simples para atualizar contagens de badges dinamicamente, útil para notificações, mensagens ou indicadores de tarefas. O plugin se integra perfeitamente a aplicativos Flutter existentes e suporta rótulos de badge inteiros e personalizados. Projetado para consistência entre plataformas, garante visibilidade de badges onde suportado por cada sistema operacional. Ideal para aplicativos que exigem atualizações de status em tempo real diretamente no ícone da tela inicial.

Casos de uso

  • Exibindo contagem de mensagens não lidas
  • Mostrando notificações de tarefas pendentes
  • Indicando disponibilidade de novo conteúdo
  • Atualizando badges de ícones de aplicativos em tempo real
  • Aumentando o engajamento do usuário por meio de pistas visuais

Principais recursos

  • Suporte multiplataforma (Android, iOS, macOS)
  • API simples para atualizações de badge
  • Suporte para rótulos de badge inteiros e personalizados
  • Renderização em tempo real do distintivo
  • Configuração e integração mínimas

Indicado para

  • Aplicativos de mensagens e bate-papo
  • Aplicativos de tarefas e produtividade
  • aplicativos com muitas notificações
  • Aplicativos com atualizações de conteúdo dinâmico
  • Desenvolvedores direcionados para múltiplas plataformas

Considerações

  • O suporte a badges varia conforme a plataforma e a versão do sistema operacional
  • Alguns plataformas podem limitar o tamanho da contagem de medalhas
  • Nem todos os dispositivos suportam texto personalizado no badge
  • Requer permissões específicas da plataforma em alguns sistemas
  • Opções limitadas de personalização visual

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

app_badge_plus

Pub Version Pub Points GitHub

A Flutter plugin for adding badges to your app icon. Supports iOS, Android, and macOS.

iOS pixel samsung macOS

Supported Platforms

  • iOS
  • Android
    • Samsung (pass)
    • Oppo (pass)
    • Vivo (pass)
    • Huawei (pass)
    • Xiaomi / POCO (HyperOS)
    • LG
    • Sony
    • HTC
    • ZTX
  • macOS

Mark

Android

Starting with Android 8.0 (API level 26), notification badges—also known as notification dots—appear on a launcher icon when the associated app has an active notification. Users can touch & hold the app icon to reveal the notifications, along with any app shortcuts.

https://developer.android.com/develop/ui/views/notifications/badges

Starting With Android13 (API level 33), notification runtime permission should be requested before setting the app badge.

On POCO / Xiaomi HyperOS, numeric badges are driven by active notifications (the old extraNotification API is unavailable). Grant notification permission and enable the numeric badge style in system settings.

Add the following permissions to AndroidManifest.xml according to the system you need to support:

<!-- Samsung -->
<uses-permission android:name="com.sec.android.provider.badge.permission.READ"/>
<uses-permission android:name="com.sec.android.provider.badge.permission.WRITE"/>

<!-- HTC -->
<uses-permission android:name="com.htc.launcher.permission.READ_SETTINGS"/>
<uses-permission android:name="com.htc.launcher.permission.UPDATE_SHORTCUT"/>

<!-- Sony -->
<uses-permission android:name="com.sonyericsson.home.permission.BROADCAST_BADGE"/>
<uses-permission android:name="com.sonymobile.home.permission.PROVIDER_INSERT_BADGE"/>

<!-- Apex -->
<uses-permission android:name="com.anddoes.launcher.permission.UPDATE_COUNT"/>

<!-- Solid -->
<uses-permission android:name="com.majeur.launcher.permission.UPDATE_BADGE"/>

<!-- Huawei -->
<uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE" />
<uses-permission android:name="com.huawei.android.launcher.permission.READ_SETTINGS" />
<uses-permission android:name="com.huawei.android.launcher.permission.WRITE_SETTINGS" />
iOS

On iOS, when using with notification message, notification permission is required.

macOS

On macOS, when using with notification message, notification permission is required.

permission_handler

Using permission_handler package to manage permission on Android and iOS.

https://pub.dev/packages/permission_handler

Usage

To use this plugin, add app_badge_plus as a dependency in your pubspec.yaml file.

dependencies:
  app_badge_plus: ^1.1.2

Example

import 'package:app_badge_plus/app_badge_plus.dart';

// Set badge
AppBadgePlus.updateBadge(5);

// Remove badge
AppBadgePlus.updateBadge(0);

// Whether the launcher supports badges. It always returns true on iOS and it will return false on Android if the launcher doesn't support badges.
AppBadgePlus.isSupported();

Compare

flutter_app_badger

https://pub.dev/packages/flutter_app_badger

Set badge
FlutterAppBadger.updateBadgeCount(1);

replace to

AppBadgePlus.updateBadge(1);
Remove badge
FlutterAppBadger.removeBadge();

replace to

AppBadgePlus.updateBadge(0);
Device support
FlutterAppBadger.isAppBadgeSupported();

using dart API:

import 'dart:io';

Platform.isAndroid || Platform.isIOS

Categorias

Dependências

Lista de dependências 1 itens

  • plugin_platform_interface^2.1.8

Repositório-fonte

Projetos que usam este pacote