FireForNet.Firebase.Installations 1.0.1-preview.22

Prefix Reserved

This is a prerelease version of FireForNet.Firebase.Installations.

dotnet add package FireForNet.Firebase.Installations --version 1.0.1-preview.22

NuGet\Install-Package FireForNet.Firebase.Installations -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.Installations" 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.Installations" Version="1.0.1-preview.22" />
                    

                            Directory.Packages.props

<PackageReference Include="FireForNet.Firebase.Installations" />
                    

                            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.Installations --version 1.0.1-preview.22

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: FireForNet.Firebase.Installations, 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.Installations@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.Installations&version=1.0.1-preview.22&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=FireForNet.Firebase.Installations&version=1.0.1-preview.22&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

FireForNet.Firebase.Installations

Firebase Installations for the FireForNet Firebase Client SDK for .NET.

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 manages Firebase Installations identity for FireForNet:

Firebase Installation IDs (FID)
Installation auth tokens
Installation deletion
Caching

Services such as Remote Config consume IFirebaseInstallations directly.

Installation

dotnet add package FireForNet.Firebase.Installations

Targets net10.0. References FireForNet.Firebase.Core transitively.

Setup

builder.Services.AddFirebaseInstallations();

Platform packages extend the returned FirebaseInstallationsBuilder:

builder.Services.AddFirebaseInstallations().UseBlazor(...);   // Blazor (all hosting models)
builder.Services.AddFirebaseInstallations().UseBrowser();     // framework-independent WASM
builder.Services.AddFirebaseInstallations().UseWindows();     // Windows desktop
builder.Services.AddFirebaseInstallations().UseAndroid(...);  // native (non-MAUI) Android
builder.Services.AddFirebaseInstallations().UseApple(...);    // iOS / macOS / Mac Catalyst
builder.Services.AddFirebaseInstallations().UseSqlite(path);  // SQLite persistence

Most apps receive this package transitively through Remote Config or the Messaging platform packages.

Usage

Resolve IFirebaseInstallations from DI:

public class InstallationService(IFirebaseInstallations installations)
{
    public async Task<string> GetInstallationIdAsync() =>
        await installations.GetIdAsync();

    public async Task<string> GetAuthTokenAsync()
    {
        var token = await installations.GetTokenAsync();
        return token.Token;
    }

    public async Task DeleteInstallationAsync() =>
        await installations.DeleteAsync();
}

Installation ID changes can be observed with OnIdChanged, which returns an IAsyncDisposable that unregisters the callback when disposed.

Package	Purpose
`FireForNet.Firebase.Installations.Blazor`	Blazor integration (WebAssembly, Server, Hybrid, Auto)
`FireForNet.Firebase.Installations.Browser`	Framework-independent WASM integration
`FireForNet.Firebase.Installations.Windows`	Windows desktop integration
`FireForNet.Firebase.Installations.Android`	Native (non-MAUI) Android integration
`FireForNet.Firebase.Installations.Apple`	Apple native integration (iOS, macOS, Mac Catalyst)
`FireForNet.Firebase.Installations.Sqlite`	Platform-agnostic SQLite persistence

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.

The RC milestone will be followed by an extensive cross-platform validation and testing phase before the first GA release.

All FireForNet packages are part of a coordinated release train and share the same version number.

Source Availability

FireForNet is currently being developed in a private source repository during the Preview development phase. The source will be made publicly available as the project approaches its open-source phase, with the public repository established from the appropriate release milestone.

Until then, NuGet Preview packages provide the public distribution channel for evaluating and using FireForNet.

License

This package is licensed under the Apache-2.0 license.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- FireForNet.Firebase.Core (>= 1.0.1-preview.22)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)

NuGet packages (7)

Showing the top 5 NuGet packages that depend on FireForNet.Firebase.Installations:

Package	Downloads
FireForNet.Firebase.RemoteConfig Firebase Remote Config implementation for FireForNet SDK	1.9K
FireForNet.Firebase.Installations.Blazor Package Description	1.9K
FireForNet.Firebase.Installations.Browser Package Description	679
FireForNet.Firebase.Installations.Sqlite Package Description	188
FireForNet.Firebase.Installations.Windows Package Description	183

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.1-preview.22	102	9/27/2026
1.0.1-preview.21	103	9/22/2026
1.0.1-preview.20	101	9/18/2026
1.0.1-preview.19	99	9/12/2026
1.0.1-preview.18	119	8/24/2026
1.0.1-preview.17	116	8/9/2026
1.0.1-preview.16	112	8/9/2026
1.0.1-preview.15	104	8/8/2026
1.0.1-preview.14	116	8/8/2026
1.0.1-preview.13	102	7/23/2026
1.0.1-preview.12	110	7/9/2026
1.0.1-preview.11	102	6/29/2026
1.0.1-preview.10	103	6/25/2026
1.0.1-preview.9	89	6/24/2026
1.0.1-preview.8	92	6/23/2026
1.0.1-preview.7	100	6/9/2026
1.0.1-preview.6	89	6/8/2026
1.0.1-preview.5	87	6/8/2026
1.0.1-preview.4	99	6/8/2026
1.0.1-preview.3	79	6/8/2026

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

v1.0.1-preview.21
- No functional changes; synchronized with the framework-free MAUI integration sweep.

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

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

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

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

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

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

v1.0.1-preview.14
- InstallationTokenResult is now owned by this package (moved from Core).
- Removed the IInstallationTokenSource contract; consumers inject IFirebaseInstallations directly for installation identity and auth tokens.

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

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

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

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

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

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

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

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

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

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

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

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

v1.0.1-preview.1
- Added platform store integration support (Blazor, Browser, Sqlite, Windows, Maui) via IInstallationStore.
- InMemoryInstallationStore remains the default when no platform store is registered.
- Bumped to preview10.

v1.0.0-preview9
- Synchronized package version with the preview9 release.

v1.0.0-preview8
- Synchronized package version with the preview8 release.

v1.0.0-preview7
- Synchronized package version with the preview7 Firestore local-cache architecture rework release.

v1.0.0-preview6
- Synchronized package version with the preview6 release.

v1.0.0-preview5
- Synchronized package version with the preview5 release.

v1.0.0-preview4
- Synchronized package version with the preview4 release.

v1.0.0-preview3
- Synchronized package version with the preview3 release.

v1.0.0-preview2
- Initial v1.0.0-preview2 package.