AppBadgePlus는 Android, iOS 및 macOS 플랫폼에서 앱 아이콘에 배지를 표시할 수 있도록 해주는 Flutter 플러그인입니다. 알림, 메시지 또는 작업 지표용으로 동적으로 배지 카운트를 업데이트할 수 있는 간단한 API를 제공합니다. 기존의 Flutter 앱에 원활하게 통합되며 정수 및 사용자 정의 배지 레이블을 모두 지원합니다. 크로스플랫폼 일관성을 위해 설계되어 각 운영 체제가 지원하는 범위 내에서 배지가 표시되도록 보장합니다. 홈 화면 아이콘에서 실시간 상태 업데이트가 필요한 앱에 이상적입니다.
사용 사례
읽지 않은 메시지 수 표시
보류 중인 작업 알림 표시
새로운 콘텐츠 사용 가능 여부 표시
실시간으로 앱 아이콘 배지 업데이트
시각적 신호를 통한 사용자 참여 강화
주요 기능
크로스 플랫폼 지원 (Android, iOS, macOS)
배지 업데이트를 위한 간단한 API
정수 및 사용자 지정 배지 레이블 지원
실시간 배지 렌더링
최소 설정 및 통합
적합한 대상
메시징 및 채팅 애플리케이션
작업 및 생산성 앱
알림이 많은 앱
동적 콘텐츠 업데이트가 있는 앱
다중 플랫폼을 대상으로 하는 개발자
고려 사항
배지 지원은 플랫폼 및 OS 버전에 따라 다릅니다
일부 플랫폼은 배지 수량 크기 제한이 있을 수 있습니다
모든 기기에서 사용자 지정 배지 텍스트를 지원하지 않습니다
일부 시스템에서는 플랫폼별 권한이 필요합니다
제한된 시각적 사용자 정의 옵션
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
app_badge_plus
A Flutter plugin for adding badges to your app icon. Supports iOS, Android, and 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.
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:
import'package:app_badge_plus/app_badge_plus.dart';
// Set badgeAppBadgePlus.updateBadge(5);
// Remove badgeAppBadgePlus.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();