PushNotifications.Server.AspNetCore 1.3.23-pre

.NET 5.0 .NET Core 3.1 .NET Standard 2.0
This is a prerelease version of PushNotifications.Server.AspNetCore.
There is a newer version of this package available.
See the version list below for details.
Install-Package PushNotifications.Server.AspNetCore -Version 1.3.23-pre
dotnet add package PushNotifications.Server.AspNetCore --version 1.3.23-pre
<PackageReference Include="PushNotifications.Server.AspNetCore" Version="1.3.23-pre" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add PushNotifications.Server.AspNetCore --version 1.3.23-pre
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: PushNotifications.Server.AspNetCore, 1.3.23-pre"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install PushNotifications.Server.AspNetCore as a Cake Addin
#addin nuget:?package=PushNotifications.Server.AspNetCore&version=1.3.23-pre&prerelease

// Install PushNotifications.Server.AspNetCore as a Cake Tool
#tool nuget:?package=PushNotifications.Server.AspNetCore&version=1.3.23-pre&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

PushNotifications.Server

Version Downloads

Server-side .NET library for sending push notifications to Apple Push Notification Service (APNS) and Google's Firebase Cloud Messaging (FCM).

Download and Install PushNotifications

This library is available on NuGet: https://www.nuget.org/packages/PushNotifications.Server Use the following command to install PushNotifications.Server using NuGet package manager console:

PM> Install-Package PushNotifications.Server

You can use this library in any .NET project which is compatible to .NET Standard 2.0 and higher.

ASP.NET Core Integration

For a smooth integration with ASP.NET Core projects, use following NuGet package: https://www.nuget.org/packages/PushNotifications.Server.AspNetCore Use the following command to install PushNotifications.Server.AspNetCore using NuGet package manager console:

PM> Install-Package PushNotifications.Server.AspNetCore

You can use this library in any ASP.NET Core project which is compatible to .NET Core 3.1 and higher.

Configure using appsettings.json

API Usage

The following sections document basic use cases of this library. The following code excerpts can also be found in the sample applications.

Cross-Platform Push Notifications

The goal of cross-platform push notification is to provide an abstracted request/response model in order to serve all unterlying platforms. PushNotificationClient is the implementation class of such a cross-platform push notification client. In order to create a new instance of PushNotificationClient, you have to create an instance of FcmClient and ApnsClient and pass it into PushNotificationClient.

var pushNotificationClient = new PushNotificationClient(fcmClient, apnsClient);
Sending PushRequests to all platforms

Cross-platform push requests are abstracted using class PushRequest. Create a new PushRequest and send it using the SendAsync method of PushNotificationClient.

var pushRequest = new PushRequest
{
    Content = new PushContent
    {
        Title = "Test Message",
        Body = $"Message @ {DateTime.Now}",
        CustomData = new Dictionary<string, string>
        {
            { "key", "value" }
        }
    },
    Devices = pushDevices
};

var pushResponse = await this.pushNotificationClient.SendAsync(pushRequest);
APNS Push Notifications (iOS / Apple)

Sending push notifications to iOS devices is pretty easy. Create a new instance of ApnsClient.

IApnsClient apnsClient = new ApnsClient(apnsJwtOptions);

Then, create an ApnsRequest with some title and body and send it out using SendAsync method.

var apnsRequest = new ApnsRequest(ApplePushType.Alert)
    .AddToken(token)
    .AddAlert("Test Message", $"Message @ {DateTime.Now}")
    .AddCustomProperty("key", "value");

var apnsResponse = await this.apnsClient.SendAsync(apnsRequest);
FCM Push Notifications (Android / Google)

In order to send FCM push notifications, you have to create a new instance of FcmClient. FcmClient requires an instance of FcmOptions, which contains the FCM configuration parameters which can be found on http://firebase.google.com. You can either create a FcmOptions manually (new FcmOptions{ ... }) or by binding from a appsettings.json file. See sample projects for more info.

This library supports both, the old "legacy" FcmClient as well as the new "v1" FcmClient. Check the firebase migration documentations before before selecting one or the other.

Sending Push Notifications using FcmClient (HTTP v1 API)
IFcmClient fcmClient = new FcmClient(fcmOptions);

Create a new FcmRequest and send it using the SendAsync method of FcmClient.

var fcmRequest = new FcmRequest()
{
    Message = new Message
    {
        Token = token,
        Notification = new Notification
        {
            Title = "Test Message",
            Body = $"Message @ {DateTime.Now}",
        },
        Data = new Dictionary<string, string>
        {
            { "key", "value" }
        },
    },
    ValidateOnly = false,
};

var fcmResponse = await this.fcmClient.SendAsync(fcmRequest);
Sending Push Notifications using FcmClient (Legacy HTTP API)

All legacy FCM client related code can be found in namespace PushNotifications.Server.Google.Legacy. The way the legacy FcmClient works is similar to the v1 FcmClient. The main differences can be found in the FcmOptions as well as in the request/response model.

IFcmClient fcmClient = new FcmClient(fcmOptions);

Create a new FcmRequest and send it using the SendAsync method of FcmClient.

var fcmRequest = new FcmRequest()
{
    To = token,
    Notification = new FcmNotification
    {
        Title = "Test Message",
        Body = $"Message @ {DateTime.Now}",
    },
    Data = new Dictionary<string, string>
    {
        { "key", "value" }
    },
};

var fcmResponse = await this.fcmClient.SendAsync(fcmRequest);

Links

Handling Notification Responses from APNs https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/handling_notification_responses_from_apns

Firebase Cloud Messaging HTTP protocol https://firebase.google.com/docs/cloud-messaging/http-server-ref

Contribution

Contributors welcome! If you find a bug or you want to propose a new feature, feel free to do so by opening a new issue on github.com.

License

This project is Copyright © 2021 Thomas Galliker. Free for non-commercial use. For commercial use please contact the author.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.3.25 46 6/24/2022
1.3.23-pre 52 4/26/2022
1.3.22-pre 64 1/9/2022
1.3.21 271 1/6/2022
1.3.19-pre 74 12/16/2021
1.3.18-pre 114 11/11/2021
1.3.16 9,874 10/27/2021
1.3.14-pre 292 10/2/2021
1.3.12-pre 167 10/1/2021
1.3.0-pre 131 9/23/2021
1.2.11-pre 134 9/21/2021
1.2.10 190 9/13/2021
1.2.8-pre 123 8/30/2021
1.2.4 8,952 8/29/2021
1.2.2-pre 109 8/25/2021
1.1.13-pre.11 101 8/21/2021
1.1.11 1,931 8/17/2021
1.1.9-pre 96 8/17/2021
1.1.6-pre 106 8/17/2021
1.0.21227.2 159 8/15/2021
1.0.21226.1-pre 153 8/14/2021
1.0.21220.11-pre 154 8/8/2021
1.0.21220.8 1,772 8/8/2021
1.0.21220.6-pre 111 8/8/2021
1.0.21220.5 146 8/8/2021
1.0.21220.3-pre 117 8/8/2021

1.0.0
- Initial release