Accept notification_icon_color as preferred alias to color

[inukiwi]

Summary

Accept notification_icon_color as preferred alias to color in notification data.
The iOS app now uses notification_icon_color to specify the notification icon color, as color is not preferred due to other color attributes existing too.

This change supports the notification_icon_color parameter alongside the old color parameter.
If both parameters are present, color will be ignored.

Checklist

• New or updated tests have been added to cover the changes following the testing guidelines.
• The code follows the project's code style and best_practices.
• The changes have been thoroughly tested, and edge cases have been considered.
• Changes are backward compatible whenever feasible. Any breaking changes are documented in the changelog for users and/or in the code for developers depending on the relevance.

Any other notes

Requires update to Firebase Cloud Messaging to support the new key on Android. home-assistant/mobile-apps-fcm-push#328

Documentation PR: home-assistant/companion.home-assistant#1362

[Copilot]

Pull request overview

This PR updates the Android companion app’s notification handling to accept a new notification payload key, notification_icon_color, as the preferred alias for the existing color key. This aligns Android with the iOS app payload format while maintaining backward compatibility.

Changes:

• Prefer notification_icon_color over color when setting NotificationCompat.Builder.color
• Preserve existing behavior by falling back to color when the new key is absent

[TimoPtr]

Could you add a link to the documentation that updates this too?

[jpelgrom]

I think it would also be nice to have this string as a const like message at the top.

[inukiwi]

@TimoPtr PR for documentation: home-assistant/companion.home-assistant#1362

@jpelgrom I've moved notification_icon_color to a const, I'm assuming you didn't mean the same for color right?

[jpelgrom]

@jpelgrom I've moved notification_icon_color to a const, I'm assuming you didn't mean the same for color right?

I didn't mean the same for color but now that you mention it I would also do that one :) We try to use constants when adding something or changing things so now would be the time.