FireForNet.Firebase.Firestore.Android 1.0.1-preview.22

FireForNet.Firebase.Firestore.Android

Native (non-MAUI) Android platform integration for FireForNet Cloud Firestore.

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 provides Android-specific Cloud Firestore functionality for FireForNet. It targets net10.0-android with no MAUI dependency, making it suitable for bare .NET Android apps.

It provides:

• Network detection — AndroidNetworkDetector mirrors the Firebase Android SDK's AndroidConnectivityMonitor with a dual-strategy approach: RegisterDefaultNetworkCallback on API 24+ and a BroadcastReceiver on pre-24 devices (down to API 21, the minimum supported version), enabling Firestore stream recovery.
• Transport — native gRPC, registered automatically.
• Persistence — SQLite-backed offline cache (via FireForNet.Firebase.Firestore.Sqlite), stored in the app's private files directory (Environment.GetFolderPath(SpecialFolder.Personal)).

Installation

dotnet add package FireForNet.Firebase.Firestore.Android

Usage

services.AddFirebase(new FirebaseOptions
{
    ApiKey = "your-api-key",
    ProjectId = "your-project"
})
.AddFirestore()
.UseAndroid(options =>
{
    options.EnableNetworkDetector = true;          // default: true
    options.DatabaseFileName = "firefornet-firestore.db3";
});

MAUI apps on Android should normally call UseMaui() from FireForNet.Firebase.Firestore.Maui, which delegates to this package on the Android TFM.

Required permission

AndroidNetworkDetector queries ConnectivityManager, which requires the ACCESS_NETWORK_STATE permission in your AndroidManifest.xml:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

INTERNET is already required by the core Firebase HTTP/gRPC transport and is assumed present.

Platform / Framework Support

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.