Notification received event

[GiampaoloGabba]

Add a new event fired when a local notification is Notified.

Fixes #105

While using this plugin i missed the functionality (expecially on Android) to being able to display a custom banner when a notification is received and the app is in foreground.

Push notifications plugins are exposing the NotificationReceived event, so why not add it to local notifications? 😄

This PR adds the new event NotificationReceived with the following args:

/// <summary>
/// Returning event when a notification is received.
/// On iOS this event is fired only when the app is in foreground
/// </summary>
public class NotificationReceivedEventArgs : EventArgs
{
    /// <summary>
    /// Returning title when a notification is received.
    /// </summary>
    public string Title { get; internal set; }

    /// <summary>
    /// Returning details when a notification is received.
    /// </summary>
    public string Description { get; internal set; } = string.Empty;

    /// <summary>
    /// Returning data when a notification is received.
    /// </summary>
    public string Data { get; internal set; }
}

Notes for iOS

Due to iOS limitations, this event will be fired only when the app is in foregound

The following property has been added to give us the option to create a custom notification alert when a notification is received:

/// <summary>
/// NotificationRequest for iOS
/// </summary>
public class iOSOptions
{
    /// <summary>
    /// Setting this flag will prevent iOS from displaying the default banner when a Notification is received in foreground
    /// Default is false
    /// </summary>
    public bool HideForegroundAlert { get; set; }
}

README and Main demos are updated aswell

[thudugala]

Published with v5.1.0