Solutions for Notification Bar Icons Turning White in Android 5 Lollipop

Problem Background and Design Changes

In Android 5 Lollipop, small icons in the notification bar are displayed in white by default, as part of Google's Material Design guidelines. This change aims to deliver a more consistent and clean user interface experience. Many developers encounter issues with abnormal color display when using custom notifications, where originally colorful icons turn white on Lollipop devices.

Inappropriate Solutions and Their Limitations

A common misguided solution is to set the app's target SDK version to lower than Android Lollipop (i.e., API level 21). While this approach restores colored icon display, it introduces significant compatibility issues. By setting targetSdkVersion to 20 or below, the app cannot leverage new features introduced in Lollipop, such as Material Design components, enhanced notification systems, and performance optimizations. This contradicts best practices for continuous platform adaptation and may cause the app to lag in functionality and user experience.

Recommended Solution: Silhouette Icons and Color Adaptation

The correct solution is to adhere to Material Design guidelines by using silhouette icons combined with the setColor method. In Lollipop and later versions, notification icons should consist of monochrome outlines with transparent background areas, allowing the system to fill the specified color behind the icon. Here is a complete implementation example:

private Notification buildNotification(Context context) {
    Notification.Builder builder = new Notification.Builder(context)
        .setAutoCancel(true)
        .setContentTitle("My Notification")
        .setContentText("White silhouette on Lollipop, colored otherwise!")
        .setSmallIcon(getNotificationIcon());
    
    if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.LOLLIPOP) {
        builder.setColor(ContextCompat.getColor(context, R.color.notification_color));
    }
    
    return builder.build();
}

private int getNotificationIcon() {
    boolean useWhiteIcon = (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.LOLLIPOP);
    return useWhiteIcon ? R.drawable.icon_silhouette : R.drawable.ic_launcher;
}

In this example, the getNotificationIcon method dynamically selects icon resources based on the device version. For Lollipop and above, it uses a silhouette icon (icon_silhouette) and sets the background color via setColor; for older versions, it employs a traditional colored icon (ic_launcher).

Icon Design and Specifications

To ensure icons display correctly across devices, developers must follow specific design norms. Silhouette icons should be drawn in pure white, with all areas intended to show color kept transparent. The recommended icon size is 24x24dp, corresponding to pixel values for different screen densities as follows:

• MDPI: 24.00px
• HDPI: 36.00px
• XHDPI: 48.00px

These dimensions guarantee clear visibility on various screens while complying with Android's design standards.

Compatibility Considerations and Best Practices

When implementing notification icons, backward compatibility must be considered. Using Build.VERSION.SDK_INT for version checks is a standard practice to ensure code functions properly on older Android versions. Additionally, color resources should be defined in resource files for ease of maintenance and theme adaptation. For example, define the notification color in res/values/colors.xml:

<color name="notification_color">#FF5722</color>

This method not only resolves icon display issues but also enables the app to fully utilize Lollipop's new features, such as improved notification interactions and visual design.

Conclusion

The whitening of notification bar icons in Android 5 Lollipop is a design intention, not a bug. By adopting silhouette icons and the setColor method, developers can create notifications that conform to new design norms while maintaining backward compatibility. Avoiding the reduction of the target SDK version and focusing on adapting to the latest platform features are crucial for enhancing app quality and user experience. Referring to official design guides and sample code can assist developers in efficiently addressing such compatibility challenges.