SAMPLE APP :point_right:
Cordova plugin to access and modify the badge number of the app icon on various mobile platforms including iOS, Android and Windows.
Users see notifications in the following ways:
Execute from the projects root folder:
$ cordova plugin add cordova-plugin-badge
Or install a specific version:
$ cordova plugin add cordova-plugin-badge@VERSION
Or install the latest head version:
$ cordova plugin add https://github.com/katzer/cordova-plugin-badge.git
Or install from local source:
$ cordova plugin add cordova-plugin-badge --searchpath <path>
The plugin creates the object
cordova.plugins.notification.badge and is accessible after deviceready has been fired.
Badge numbers cannot be negative. The maximum might be restricted by the OS. A callback is optional and will be invoked with the current badge number.
There's built-in support to increase the badge number:
To decrease the badge number:
And to clear out the badge number:
The default value is 0. The badge number wont get lost after reboot or app restart.
Note: Modifying the badge number outside of the plugin does result into wrong behaivor!
To clear the badge number automatically if the user taps the app icon:
The plugin might ask for granting permissions to modify the badge number. That's done automatically but it's also possible to request them manually:
Or to check if they have been granted already:
On Android not all launchers support badges. In order to set badges the plugin uses ShortcutBadger. Check out their website to see which launchers are supported.
If you're using PhoneGap Build please make sure you specify gradle as your Android build tool in config.xml:
To specify a custom version of ShortcutBadger follow this guide. The name of the property is
// In <your-project>/platforms/android/build-extras.gradleext.appShortcutBadgerVersion = '1.1.17'
git checkout -b my-new-feature)
git commit -am 'Add some feature')
git push origin my-new-feature)
This software is released under the Apache 2.0 License.
Made with 😋 from Leipzig
© 2013 appPlant GmbH