Implementing Push Notifications in .NET MAUI for iOS

<dict>
<key>aps-environment</key>
<string>development</string> <!-- or production -->
</dict>

builder.Services.AddSingleton<IPushNotificationHandler,
PushNotificationHandler>();

In your app, call:

await Permissions.RequestAsync<Permissions.Notification>();

Step 5: Implement iOS Push Notification Registration

Create or update AppDelegate.cs:

using Foundation;
using UIKit;
using UserNotifications;
[Register("AppDelegate")]
public class AppDelegate : MauiUIApplicationDelegate
{
public override bool FinishedLaunching(UIApplication app, NSDictionary
options)
{
UNUserNotificationCenter.Current.RequestAuthorization(
UNAuthorizationOptions.Alert |
UNAuthorizationOptions.Badge |
UNAuthorizationOptions.Sound,
(approved, err) => {});
UIApplication.SharedApplication.RegisterForRemoteNotifications();
return base.FinishedLaunching(app, options);
}
public override void RegisteredForRemoteNotifications(UIApplication
application, NSData deviceToken)
{
var token = deviceToken.Description;
token = token.Trim('<', '>').Replace(" ",
"");
Console.WriteLine($"APNS Device Token: {token}");
}
public override void
FailedToRegisterForRemoteNotifications(UIApplication application, NSError
error)
{
Console.WriteLine($"Failed to register:
{error.LocalizedDescription}");
}
}

This registers the device with APNS and retrieves the device token.

Step 6: Handle Incoming Notifications

In AppDelegate.cs, add:

public override void DidReceiveRemoteNotification(UIApplication application,
NSDictionary userInfo,
Action<UIBackgroundFetchResult> completionHandler)
{
Console.WriteLine("Push received: " + userInfo);
completionHandler(UIBackgroundFetchResult.NewData);
}

Step 7: Send a Test Notification

You can send push notifications using:

Option 1: Azure Notification Hub

Use token + APNS key

Option 2: Postman (APNS HTTP/2 API)

POST →

https://api.push.apple.com/3/device/{device_token}

Headers:

authorization: bearer <JWT>
apns-topic: com.companyname.myapp

Body:

{
"aps": {
"alert": {
"title": "Hello iOS",
"body": "This is a test push notification"
},
"sound": "default"
}
}

Step 8: Important Notes for iOS

• Push notifications do not work on iOS simulators
• You must install the app on an actual device
• Proper provisioning profiles are required
• Use correct aps-environment in Entitlements.plist
• Token changes on reinstall; always update it in your backend

Best Practices

• Handle token refresh properly
• Store tokens securely in your backend
• Use silent notifications for background updates
• Follow Apple's UX guidelines for notifications
• Test both development & production environments

Conclusion

Implementing push notifications in .NET MAUI for iOS requires proper configuration of Apple Developer

settings, entitlements, device registration, and handling incoming APNS messages.

Once configured correctly, you can send real-time notifications to your iOS users using APNS, Azure

Notification Hubs, or your own backend.

This detailed guide should help you confidently integrate iOS push notifications into your .NET MAUI

application.