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

FireForNet.Firebase.Auth.Android

Native (non-MAUI) Android platform integration for FireForNet Firebase Authentication.

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 Firebase Authentication functionality for FireForNet. It targets net10.0-android with no MAUI dependency, making it suitable for bare .NET Android apps (Avalonia Android, WinUI-style Android, terminal services, etc.).

It provides:

• Token storage — KeystoreTokenStorage encrypts auth tokens at rest using Jetpack Security EncryptedFile + MasterKey (AES-256-GCM, key held in the Android KeyStore). The encrypted file lives in the app's private files directory. On corruption or key loss the file is deleted and storage returns empty.
• Web authentication (opt-in) — CustomTabsWebAuthProvider launches the Firebase __/auth/handler flow in a system browser tab via Custom Tabs.

Installation

dotnet add package FireForNet.Firebase.Auth.Android

Usage

services.AddFirebase(new FirebaseOptions
{
    ApiKey = "your-api-key",
    ProjectId = "your-project"
})
.AddFirebaseAuth()
.UseAndroid(options =>
{
    options.EnableTokenStorage = true;       // default: true
    options.EnableWebAuthProvider = true;    // default: false (opt-in, see below)
});

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

Web auth provider setup (opt-in)

EnableWebAuthProvider defaults to false because two consumer-side setup steps are required:

1. Register an IAndroidActivityContext (or rely on the default, which tracks the foreground activity via Application.RegisterActivityLifecycleCallbacks). Call DefaultAndroidActivityContext.Attach(Application) once at startup.
2. Add the redirect <intent-filter> to your AndroidManifest.xml for the scheme derived from your package name (reverse-DNS). For package com.example.app the scheme is app.example.com:

<activity android:name=".MainActivity" ...>
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="app.example.com" />
    </intent-filter>
</activity>

Forward the redirect intent from your Activity.OnNewIntent to the provider:

protected override void OnNewIntent(Intent intent)
{
    base.OnNewIntent(intent);
    _webAuthProvider.HandleCallbackAsync(intent.Data);
}

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.