-
Notifications
You must be signed in to change notification settings - Fork 58
Decorator Plugin Development
Decorator plug-in is responsible for tweaking the notification to provider better experience, such as design polishing, additional functionality and even Android Wear/Auto support.
Decorators from different developers may work in a pipeline to processing the notification one by one, ordered by "priority" attribute, which provide the hint for final ordering. (User will be allowed to re-order the decorators in settings in a future version)
Decorator is implemented by extending NevoDecoratorService class. It has two basic methods:
-
apply() receives notification to be processed and applies modifications via various APIs on the "StatusBarNotificationEvo" class.
-
onNotificationRemoved() receives the event of notification removal. Nothing can be applied to the notification here. It's commonly used to keep internal state synchronized with notification visibility state.
-
Notification sound and vibration may be interrupted if not short enough if evolved. We are currently working on a solution.
-
Evolved notifications are not automatically removed by the originating app (e.g. when app is opened). This is an API limitation in Android system, we have no proper solution for this at present. It is planned be solved with root privilege in a future version.
-
Before Android 6.0, due to platform limitation, the status-bar icon of the original notification can not be reproduced if any part of the notification is altered. We are still working on a proper solution. At present, if the icon is very important for your decorator, please file a feature request with the app name and icon file (preferable vector image xml, or PNG in xxhdpi, extracted from that target app) on the issue tracker. We'll ship the icon with Nevolution app, so your decorator could reproduce the necessary status bar icon in the altered notification.
-
If the original notification has delete intent, it is triggered when the notification is decorated (due to removal before re-posting). This may have side effect on the notification behaviors of the originating app. Please test it carefully in decorator development.
-
Notification can only be altered, but not removed by 3rd-party decorators at present. It's a design choice to prevent notification loss caused by bugs or mis-configured settings in decorators. If you have different opinion on this decision, please feel free to discuss with us in the community.
TODO