FireForNet.Firebase.Messaging.Maui 1.0.1-preview.22

Prefix Reserved
This is a prerelease version of FireForNet.Firebase.Messaging.Maui.
dotnet add package FireForNet.Firebase.Messaging.Maui --version 1.0.1-preview.22
                    
NuGet\Install-Package FireForNet.Firebase.Messaging.Maui -Version 1.0.1-preview.22
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FireForNet.Firebase.Messaging.Maui" Version="1.0.1-preview.22" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="FireForNet.Firebase.Messaging.Maui" Version="1.0.1-preview.22" />
                    
Directory.Packages.props
<PackageReference Include="FireForNet.Firebase.Messaging.Maui" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add FireForNet.Firebase.Messaging.Maui --version 1.0.1-preview.22
                    
#r "nuget: FireForNet.Firebase.Messaging.Maui, 1.0.1-preview.22"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package FireForNet.Firebase.Messaging.Maui@1.0.1-preview.22
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=FireForNet.Firebase.Messaging.Maui&version=1.0.1-preview.22&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=FireForNet.Firebase.Messaging.Maui&version=1.0.1-preview.22&prerelease
                    
Install as a Cake Tool

FireForNet.Firebase.Messaging.Maui

.NET MAUI integration for FireForNet Firebase Messaging.

About FireForNet

FireForNet is a platform-agnostic, .NET-native Firebase Client SDK developed as part of the Circuids ecosystem. It provides a consistent Firebase client development experience across .NET application environments, while allowing platform-specific implementations where Firebase requires them.

About This Package

This package wires Firebase Messaging into .NET MAUI applications. UseMaui() delegates to the native platform package on mobile target frameworks:

TFM Delegates to Registration transport Delivery
net10.0-android Messaging.Android GMS CloudMessaging (FID mode) GMS → receiver → service
net10.0-ios Messaging.Apple HTTPS (fcmregistrations.googleapis.com) APNs forwarding
net10.0-maccatalyst Messaging.Apple HTTPS (fcmregistrations.googleapis.com) APNs forwarding
net10.0-windows10.0.19041.0 Not supported — UseMaui() throws MauiFirebaseMessagingException (MessagingErrorCode.FailedPrecondition) — —

FireForNet provides no FCM delivery transport for Windows: GMS IPC does not exist outside Android and the APNs path is Apple-only. The Windows delivery transport (WNS behind the FCM surface) is planned separately. The throw fires at UseMaui() call time so misconfiguration surfaces at startup, not at first message operation.

The package is a pure delegation layer with no MAUI framework dependency. Microsoft.Maui.Controls is excluded deliberately: its AndroidX pin chain conflicts with the Google Play Services binding chain on Android, and the version unification pin is an Android-specific dependency this package must not carry. Apps that combine Microsoft.Maui.Controls with the Play Services bindings on Android add the unification pin themselves (a normal requirement for GPS-binding apps):

<PackageReference Include="Xamarin.AndroidX.Lifecycle.LiveData.Core" Version="2.11.0.1" />

Messaging requires Installations: call AddFirebaseInstallations() and configure a platform store (e.g. .UseMaui() from FireForNet.Firebase.Installations.Maui) before UseMaui() on Messaging.

Installation

dotnet add package FireForNet.Firebase.Messaging.Maui

Usage

builder.Services.AddFirebaseInstallations().UseMaui();
builder.Services.AddFirebaseMessaging().UseMaui();

Platform / Framework Support

Platform / Framework Status
Android (net10.0-android) Preview
iOS (net10.0-ios) Preview
Mac Catalyst (net10.0-maccatalyst) Preview
Windows (net10.0-windows10.0.19041.0) Not supported

Documentation

Comprehensive FireForNet documentation is being prepared for the Release Candidate stage.

Project Status

FireForNet is currently available as a Preview release and is approaching its Release Candidate milestone. APIs, package structure, and implementation details may continue to evolve before RC and GA.

Product Compatible and additional computed target framework versions.
.NET net10.0-android36.0 is compatible.  net10.0-ios26.0 is compatible.  net10.0-maccatalyst26.0 is compatible.  net10.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
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.0.1-preview.22 45 9/27/2026
1.0.1-preview.21 57 9/22/2026

v1.0.1-preview.22
- Synchronized package version with the preview.22 release.

v1.0.1-preview.21
- New package. MAUI integration delegating to Messaging.Android and Messaging.Apple on mobile TFMs; throws on the Windows TFM because no FCM delivery transport exists for Windows.

v1.0.1-preview.20
- Initial package. MAUI integration delegating to Messaging.Android and Messaging.Apple on mobile TFMs; throws on the Windows TFM because no FCM delivery transport exists for Windows.