Small notification icon (required)
- The app icon is a small two-dimensional representation of your app's identity. It appears in monochrome in the status bar. If your app sends a wide variety of notifications, you may replace your app's identity icon with a symbol that reflects the content type. For example, Google Now uses a cloud icon for weather notifications, Here's how it looks:
Android 7.0 (Nougat)
It'll appear as a white icon in status bar.
With expanded notificaiton, it'll be left to the application name.
Android 5.0, 6.0
It'll appear as a white icon in status bar.
With expanded notificaiton and in case of no large icon specified, it'll appear on a grey background on the left.
With expanded notificaiton and in case of large icon, it will set as small icon next to the large one.
Android 4.0
It'll appear as a grey icon in status bar.
With expanded notificaiton and in case of no large icon specified, it'll appear as white icon on the left.
With expanded notificaiton and in case of large icon, it will be moved to the right-hand side.
The icon should be white-on-transparent background, to quickly generate small icons with the correct settings, we recommend using the Android Asset Studio, you should use ic_stat_pushbots_sicon in name field in order to set the default small icon.
To define a custom small icon, add the following payload fields :
Payload field key: sIco
Type: String
Value: drawable id or icon from assets folder, it should be white-on-transparent background
{"payload":{"sIco":"ic_stat_custom_small_icon"}}
Large notification icon (optional)
An image may be added to reinforce the notification in a meaningful way on Android 3.0+, such as a message that includes a photo of the sender, Here's how it looks:
In Android N, the large icon is only meant for specific situations in which imagery meaningfully reinforces the notification's content, including:
Communication from another person, such as the image of someone sending a message
The source of content if it's different than the app sending the notification, such as the logo from a YouTube channel to which the user is subscribed
Meaningful symbols about the notification, such as an arrow symbol for driving directions
Large icons should be circular when showing a person, but square in all other cases. To create default large icon, just create ic_pushbots_licon.png in res/drawable-xxxhdpi folder sized 256x256, and it'll always show as largeIcon. To define a custom large icon, add the following payload fields :
The large icon is not intended for branding.
Payload field key: lIco
Type: String
Value: drawable id, icon from assets folder or image URL, the icon must be in res/drawable-xxxhdpi folder and sized 256x256
{"payload":{"lIco":"ic_custom_large_icon"}}or
{"payload":{"lIco":"https://avatars2.githubusercontent.com/u/1342004?v=3&s=400"}}For Cordova:
Copy image titled ic_pushbots_licon.png (default large icon) ic_stat_pushbots_sicon.png (default small icon):
<project-root>/platforms/android/app/src/main/res/drawable-mdpi/ (24x24)
<project-root>/platforms/android/app/src/main/res/drawable-hdpi/ (36x36)
<project-root>/platforms/android/app/src/main/res/drawable-xhdpi/ (48x48)
<project-root>/platforms/android/app/src/main/res/drawable-xxhdpi/ (72x72)
<project-root>/platforms/android/app/src/main/res/drawable-xxxhdpi/ (96x96)For Phonegap Build:
Add these lines to config.xml in platform section:
<!-- Add to android platform section for large icon licon/ and for smal icon replace it with sicon -->
<platform name="android">
<resource-file src="locales/android/drawable-mdpi/ic_pushbots_licon.png" target="res/drawable-mdpi/ic_pushbots_licon.png" />
<resource-file src="locales/android/drawable-hdpi/ic_pushbots_licon.png" target="res/drawable-hdpi/ic_pushbots_licon.png" />
<resource-file src="locales/android/drawable-xhdpi/ic_pushbots_licon.png" target="res/drawable-xhdpi/ic_pushbots_licon.png" />
<resource-file src="locales/android/drawable-xxhdpi/ic_pushbots_licon.png" target="res/drawable-xxhdpi/ic_pushbots_licon.png" />
<resource-file src="locales/android/drawable-xxxhdpi/ic_pushbots_licon.png" target="res/drawable-xxxhdpi/ic_pushbots_licon.png" />
</platform>
ic_pushbots_licon.png (default large icon) ic_stat_pushbots_sicon.png (default small icon)